獲取憑證接口接口說(shuō)明 在使用通用接口前，你需要做以下兩步工作： 1.擁有一個(gè)微信公眾賬號(hào)，并獲取到appid和appsecret 2.通過(guò)獲取憑證接口獲取到access_token access_token是第三方訪問(wèn)api資源的票據(jù)。 請(qǐng)求說(shuō)明 http請(qǐng)求方式: GET https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET 參數(shù)說(shuō)明
返回說(shuō)明 正確的Json返回結(jié)果: {"access_token":"ACCESS_TOKEN","expires_in":7200}
錯(cuò)誤的Json返回示例: {"errcode":40013,"errmsg":"invalid appid"}用戶信息接口接口說(shuō)明 第三方通過(guò)openid獲取用戶信息。 請(qǐng)求說(shuō)明 http請(qǐng)求方式: GET https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid=OPENID 參數(shù)說(shuō)明
返回說(shuō)明 正確的Json返回結(jié)果: {"subscribe":1,"openid":"OPENID","nickname":"NICKNAME","sex":1,"language":"LANGUAGE","city":"CITY"}
錯(cuò)誤的Json返回結(jié)果: {"errcode":40013,"errmsg":"invalid appid"}媒體文件上傳接口接口說(shuō)明 上傳圖片、語(yǔ)音、視頻等文件，獲取media_id，media_id可復(fù)用。 請(qǐng)求說(shuō)明 http請(qǐng)求方式: POST/FORM http://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE 參數(shù)說(shuō)明
請(qǐng)求示例 curl -F "media=@test.jpg" "http://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE" 返回說(shuō)明 正確的Json返回結(jié)果: {"type":"TYPE","media_id":"MEDIA_ID","created_at":123456789}
錯(cuò)誤的Json返回示例: {"errcode":40004,"errmsg":"invalid media type"}注意事項(xiàng) 1.上傳的媒體文件限制： 圖片（image）: 1MB，支持JPG格式 語(yǔ)音（voice）：1MB，播放長(zhǎng)度不超過(guò)60s，支持AMR格式 視頻（video）：10MB，支持MP4格式 縮略圖（thumb）：64KB，支持JPG格式 2.媒體文件在后臺(tái)保存時(shí)間為3天，即3天后media_id失效 媒體文件獲取接口接口說(shuō)明 通過(guò)media_id獲取圖片、語(yǔ)音、視頻等文件 請(qǐng)求說(shuō)明 http請(qǐng)求方式: GET http://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID 參數(shù)說(shuō)明
請(qǐng)求示例 curl -I -G "http://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID" 返回頭： HTTP/1.1 200 OK Connection: close Content-Type: image/jpeg Content-disposition: attachment; filename="MEDIA_ID.jpg" Date: Sun, 06 Jan 2013 10:20:18 GMT Cache-Control: no-cache, must-revalidate Content-Length: 339721 curl -G "http://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID" 錯(cuò)誤返回: {"errcode":40007,"errmsg":"invalid media_id"}
發(fā)送消息接口接口說(shuō)明 發(fā)送消息給普通用戶 請(qǐng)求說(shuō)明 http請(qǐng)求方式: POST https://api.weixin.qq.com/cgi-bin/message/send?access_token=ACCESS_TOKEN 發(fā)送文本 { "touser":"OPENID", "msgtype":"text", "text": { "content":"Hello World" } } 發(fā)送圖片 { "touser":"OPENID", "msgtype":"image", "image": { "media_id":"MEDIA_ID" } } 發(fā)送語(yǔ)音 { "touser":"OPENID", "msgtype":"voice", "voice": { "media_id":"MEDIA_ID" } } 發(fā)送視頻 { "touser":"OPENID", "msgtype":"video", "video": { "media_id":"MEDIA_ID", "thumb_media_id":"THUMB_MEDIA_ID" } } 發(fā)送音樂(lè)消息 { "touser":"OPENID", "msgtype":"music", "music": { "title":"MUSIC_TITLE", "description":"MUSIC_DESCRIPTION", "musicurl":"MUSIC_URL", "hqmusicurl":"HQ_MUSIC_URL", "thumb_media_id":"THUMB_MEDIA_ID" } } 發(fā)送圖文消息（支持1-10條圖文展示） { "touser":"OPENID", "msgtype":"news", "news":{ "articles": [ { "title":"Happy Day", "description":"Is Really A Happy Day", "url":"URL", "picurl":"PIC_URL" } ] } } 參數(shù)說(shuō)明
請(qǐng)求示例 curl -d "{\"touser\":\"OPENID\",\"msgtype\":\"text\",\"text\":{\"content\":\"Hello World\"}}" "http://api.weixin.qq.com/cgi-bin/message/send?access_token=ACCESS_TOKEN"
返回：
{"errcode":0,"errmsg":"ok"}返回說(shuō)明 正確的Json返回結(jié)果： {"errcode":0,"errmsg":"ok"}錯(cuò)誤的Json返回示例: {"errcode":40008,"errmsg":"invalid message type"}媒體文件發(fā)送接口接口說(shuō)明 使用/media/upload和/message/send的接口，發(fā)送媒體文件一步到位 請(qǐng)求說(shuō)明 http請(qǐng)求方式: POST/FORM http://api.weixin.qq.com/cgi-bin/media/send?access_token=ACCESS_TOKEN&type=TYPE&touser=OPENID 參數(shù)說(shuō)明
請(qǐng)求示例 curl -F "media=@test.mp4" "http://api.weixin.qq.com/cgi-bin/media/send?access_token=ACCESS_TOKEN&type=video&touser=OPENID" 返回： {"errcode":0,"errmsg":"ok"} 返回說(shuō)明 正確的Json返回結(jié)果: {"errcode":0,"errmsg":"ok"}錯(cuò)誤的Json返回示例: {"errcode":40004,"errmsg":"invalid media type"}拉取關(guān)注接口接口說(shuō)明 拉取公眾賬戶關(guān)注用戶列表 請(qǐng)求說(shuō)明 http請(qǐng)求方式: GET https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID 參數(shù)說(shuō)明
返回說(shuō)明 正確的Json返回結(jié)果: {"total":2,"count":2,"data":{"openid":["","OPENID1","OPENID2"]},"next_openid":"NEXT_OPENID"}
錯(cuò)誤的Json返回示例: {"errcode":40013,"errmsg":"invalid appid"}注意事項(xiàng) 若公眾賬號(hào)關(guān)注人數(shù)超過(guò)10000，則可以通過(guò)填寫(xiě)next_openid的值獲取 例子： 公眾賬號(hào)A擁有23000個(gè)關(guān)注的人，想通過(guò)拉取關(guān)注接口獲取所有關(guān)注的人，那么分別請(qǐng)求url如下： https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN 返回結(jié)果: { "total":23000, "count":10000, "data":{" openid":[ "OPENID1", "OPENID2", ..., "OPENID10000" ] }, "next_openid":"NEXT_OPENID1" } https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID1 返回結(jié)果: { "total":23000, "count":10000, "data":{ "openid":[ "OPENID10001", "OPENID10002", ..., "OPENID20000" ] }, "next_openid":"NEXT_OPENID2" } https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID2 返回結(jié)果: { "total":23000, "count":3000, "data":{" "openid":[ "OPENID20001", "OPENID20002", ..., "OPENID23000" ] }, "next_openid":"NEXT_OPENID3" } CATEGORIES |
|
|
情殤影魂 
2013 年 3 月 22 日
