电竞比分网-中国电竞赛事及体育赛事平台

搜索
分享

微信公眾平臺(tái)關(guān)于消息接口的內(nèi)部資料（外界暫無(wú)流通）

 輕應(yīng)用開發(fā) 2014-01-23



獲取憑證接口


接口說明


在使用通用接口前，你需要做以下兩步工作：


1.擁有一個(gè)微信公眾賬號(hào)，并獲取到appid和appsecret


2.通過獲取憑證接口獲取到access_token


access_token是第三方訪問api資源的票據(jù)。


請(qǐng)求說明


http請(qǐng)求方式: GET
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

參數(shù)說明

























參數(shù)是否必須說明
grant_type是獲取access_token填寫client_credential
appid是第三方用戶唯一憑證
secret是第三方用戶唯一憑證密鑰，既appsecret

返回說明


正確的Json返回結(jié)果:


{"access_token":"ACCESS_TOKEN","expires_in":7200}
















參數(shù)說明
access_token獲取到的憑證
expires_in憑證有效時(shí)間，單位：秒

錯(cuò)誤的Json返回示例:


{"errcode":40013,"errmsg":"invalid appid"}

統(tǒng)一返回碼說明


用戶信息接口


接口說明


第三方通過openid獲取用戶信息。


請(qǐng)求說明


http請(qǐng)求方式: GET
https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid=OPENID

參數(shù)說明




















參數(shù)是否必須說明
access_token是調(diào)用接口憑證
openid是普通用戶的標(biāo)識(shí)，對(duì)當(dāng)前公眾號(hào)唯一

返回說明


正確的Json返回結(jié)果:


{"subscribe":1,"openid":"OPENID","nickname":"NICKNAME","sex":1,"language":"LANGUAGE","city":"CITY"}
































參數(shù)說明
subscribe用戶是否訂閱該公眾號(hào)標(biāo)識(shí)，值為0時(shí)，拉取不到其余信息
openid用戶的標(biāo)識(shí)，對(duì)當(dāng)前公眾號(hào)唯一
nickname用戶的昵稱
sex用戶的性別，值等于1時(shí)為男性，值等于2時(shí)為女性
city用戶所在城市
language用戶的語(yǔ)言，簡(jiǎn)體中文為zh_CN

錯(cuò)誤的Json返回結(jié)果:


{"errcode":40013,"errmsg":"invalid appid"}

統(tǒng)一返回碼說明


媒體文件上傳接口


接口說明


上傳圖片、語(yǔ)音、視頻等文件，獲取media_id，media_id可復(fù)用。


請(qǐng)求說明


http請(qǐng)求方式: POST/FORM
http://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE

參數(shù)說明

























參數(shù)是否必須說明
access_token是調(diào)用接口憑證
type是媒體文件類型，分別有圖片（image）、語(yǔ)音（voice）、視頻（video）和縮略圖（thumb）
media是form-data中媒體文件標(biāo)識(shí)，有filename、filelength、content-type等信息

請(qǐng)求示例


 curl -F "media=@test.jpg" "http://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE"

返回說明


正確的Json返回結(jié)果:


{"type":"TYPE","media_id":"MEDIA_ID","created_at":123456789}




















參數(shù)說明
type媒體文件類型，分別有圖片（image）、語(yǔ)音（voice）、視頻（video）和縮略圖（thumb）
media_id媒體文件上傳后獲取的唯一標(biāo)識(shí)
created_at媒體文件上傳時(shí)間

錯(cuò)誤的Json返回示例:


{"errcode":40004,"errmsg":"invalid media type"}

統(tǒng)一返回碼說明


注意事項(xiàng)


1.上傳的媒體文件限制：


圖片（image）: 1MB，支持JPG格式
語(yǔ)音（voice）：1MB，播放長(zhǎng)度不超過60s，支持AMR格式
視頻（video）：10MB，支持MP4格式
縮略圖（thumb）：64KB，支持JPG格式

2.媒體文件在后臺(tái)保存時(shí)間為3天，即3天后media_id失效


媒體文件獲取接口


接口說明


通過media_id獲取圖片、語(yǔ)音、視頻等文件


請(qǐng)求說明


http請(qǐng)求方式: GET
http://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID

參數(shù)說明




















參數(shù)是否必須說明
access_token是調(diào)用接口憑證
media_id是媒體文件id

請(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ā)送消息接口


接口說明


發(fā)送消息給普通用戶


請(qǐng)求說明


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ā)送音樂消息
{
    "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ù)說明

































































參數(shù)是否必須說明
access_token是調(diào)用接口憑證
touser是普通用戶openid
msgtype是消息類型，支持文本（text）、圖片（image）、語(yǔ)音（voice）、視頻（video）
media_idimage必須

voice必須

video必須		媒體文件id
thumb_media_idvideo必須

music非必須		媒體文件id
title否消息標(biāo)題
description否消息描述
url否點(diǎn)擊鏈接跳轉(zhuǎn)地址
picurl否圖片鏈接，支持JPG、PNG格式，較好的效果為大圖640*320，小圖80*80
musicurl否音樂鏈接
hqmusicurl否高品質(zhì)音樂鏈接，wifi環(huán)境優(yōu)先使用該鏈接播放音樂

請(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"}

返回說明


正確的Json返回結(jié)果：


{"errcode":0,"errmsg":"ok"}

錯(cuò)誤的Json返回示例:


{"errcode":40008,"errmsg":"invalid message type"}

統(tǒng)一返回碼說明


媒體文件發(fā)送接口


接口說明


使用/media/upload和/message/send的接口，發(fā)送媒體文件一步到位


請(qǐng)求說明


http請(qǐng)求方式: POST/FORM
http://api.weixin.qq.com/cgi-bin/media/send?access_token=ACCESS_TOKEN&type=TYPE&touser=OPENID

參數(shù)說明

























參數(shù)是否必須說明
access_token是調(diào)用接口憑證
type是媒體文件類型
touser是普通用戶OPENID

請(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"}

返回說明


正確的Json返回結(jié)果:


{"errcode":0,"errmsg":"ok"}

錯(cuò)誤的Json返回示例:


{"errcode":40004,"errmsg":"invalid media type"}

統(tǒng)一返回碼說明


拉取關(guān)注接口


接口說明


拉取公眾賬戶關(guān)注用戶列表


請(qǐng)求說明


http請(qǐng)求方式: GET
https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID

參數(shù)說明




















參數(shù)是否必須說明
access_token是調(diào)用接口憑證
next_openid否獲取關(guān)注用戶列表偏移量，不填默認(rèn)從頭開始拉取

返回說明


正確的Json返回結(jié)果:


{"total":2,"count":2,"data":{"openid":["","OPENID1","OPENID2"]},"next_openid":"NEXT_OPENID"}
























參數(shù)說明
total關(guān)注該公眾賬號(hào)的總用戶數(shù)
count拉取的OPENID個(gè)數(shù)，最大值為10000
data列表數(shù)據(jù)，OPENID的列表
next_openid下一次拉取的關(guān)注用戶的偏移值

錯(cuò)誤的Json返回示例:


{"errcode":40013,"errmsg":"invalid appid"}

統(tǒng)一返回碼說明


注意事項(xiàng)


若公眾賬號(hào)關(guān)注人數(shù)超過10000，則可以通過填寫next_openid的值獲取 例子：


公眾賬號(hào)A擁有23000個(gè)關(guān)注的人，想通過拉取關(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"
}

贊       
penghu20

等1人贊過


  • penghu20




   
   
   
   
   
    
    
  

    本站是提供個(gè)人知識(shí)管理的網(wǎng)絡(luò)存儲(chǔ)空間，所有內(nèi)容均由用戶發(fā)布，不代表本站觀點(diǎn)。請(qǐng)注意甄別內(nèi)容中的聯(lián)系方式、誘導(dǎo)購(gòu)買等信息，謹(jǐn)防詐騙。如發(fā)現(xiàn)有害或侵權(quán)內(nèi)容，請(qǐng)點(diǎn)擊一鍵舉報(bào)。
    轉(zhuǎn)藏 分享 獻(xiàn)花（0）

    0條評(píng)論

    發(fā)表

    請(qǐng)遵守用戶 評(píng)論公約

    類似文章 更多