微信公众平台关于消息接口的内部资料外界暂无流通 公众流通股

微信公众平台关于消息接口的内部资料(外界暂无流通)

  情殇影魂   2013 年 3 月 22 日

获取凭证接口

接口说明

在使用通用接口前,你需要做以下两步工作:

1.拥有一个微信公众账号,并获取到appid和appsecret

2.通过获取凭证接口获取到access_token

access_token是第三方访问api资源的票据。

请求说明

http请求方式: GEThttps://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

参数说明

参数

是否必须

说明

grant_type



获取access_token填写client_credential

appid



第三方用户唯一凭证

secret



第三方用户唯一凭证密钥,既appsecret

返回说明

正确的Json返回结果:

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

参数

说明

access_token

获取到的凭证

expires_in

凭证有效时间,单位:秒

错误的Json返回示例:

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

统一返回码说明

用户信息接口

接口说明

第三方通过openid获取用户信息。

请求说明

http请求方式: GEThttps://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid=OPENID

参数说明

参数

是否必须

说明

access_token



调用接口凭证

openid



普通用户的标识,对当前公众号唯一

返回说明

正确的Json返回结果:

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

参数

说明

subscribe

用户是否订阅该公众号标识,值为0时,拉取不到其余信息

openid

用户的标识,对当前公众号唯一

nickname

用户的昵称

sex

用户的性别,值等于1时为男性,值等于2时为女性

city

用户所在城市

language

用户的语言,简体中文为zh_CN

错误的Json返回结果:

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

统一返回码说明

媒体文件上传接口

接口说明

上传图片、语音、视频等文件,获取media_id,media_id可复用。

请求说明

http请求方式: POST/FORMhttp://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE

参数说明

参数

是否必须

说明

access_token
微信公众平台关于消息接口的内部资料(外界暂无流通) 公众流通股



调用接口凭证

type



媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb)

media



form-data中媒体文件标识,有filename、filelength、content-type等信息

请求示例

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

返回说明

正确的Json返回结果:

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

参数

说明

type

媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb)

media_id

媒体文件上传后获取的唯一标识

created_at

媒体文件上传时间

错误的Json返回示例:

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

统一返回码说明

注意事项

1.上传的媒体文件限制:

图片(image): 1MB,支持JPG格式语音(voice):1MB,播放长度不超过60s,支持AMR格式视频(video):10MB,支持MP4格式缩略图(thumb):64KB,支持JPG格式

2.媒体文件在后台保存时间为3天,即3天后media_id失效

媒体文件获取接口

接口说明

通过media_id获取图片、语音、视频等文件

请求说明

http请求方式: GEThttp://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID

参数说明

参数

是否必须

说明

access_token



调用接口凭证

media_id



媒体文件id

请求示例

curl -I -G "http://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID"返回头:HTTP/1.1 200 OKConnection: closeContent-Type: image/jpeg Content-disposition: attachment; filename="MEDIA_ID.jpg"Date: Sun, 06 Jan 2013 10:20:18 GMTCache-Control: no-cache, must-revalidateContent-Length: 339721curl -G "http://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID"错误返回:{"errcode":40007,"errmsg":"invalid media_id"}

发送消息接口

接口说明

发送消息给普通用户

请求说明

http请求方式: POSThttps://api.weixin.qq.com/cgi-bin/message/send?access_token=ACCESS_TOKEN发送文本{ "touser":"OPENID", "msgtype":"text", "text": { "content":"Hello World" }}发送图片{ "touser":"OPENID", "msgtype":"image", "image": { "media_id":"MEDIA_ID" }}发送语音{ "touser":"OPENID", "msgtype":"voice", "voice": { "media_id":"MEDIA_ID" }}发送视频{ "touser":"OPENID", "msgtype":"video", "video": { "media_id":"MEDIA_ID", "thumb_media_id":"THUMB_MEDIA_ID" }}发送音乐消息{ "touser":"OPENID", "msgtype":"music", "music": { "title":"MUSIC_TITLE", "description":"MUSIC_DESCRIPTION", "musicurl":"MUSIC_URL", "hqmusicurl":"HQ_MUSIC_URL", "thumb_media_id":"THUMB_MEDIA_ID" }}发送图文消息(支持1-10条图文展示){ "touser":"OPENID", "msgtype":"news", "news":{ "articles": [ { "title":"Happy Day", "description":"Is Really A Happy Day", "url":"URL", "picurl":"PIC_URL" } ] }}

参数说明

参数

是否必须

说明

access_token



调用接口凭证

touser



普通用户openid

msgtype



消息类型,支持文本(text)、图片(image)、语音(voice)、视频(video)

media_id

image必须

voice必须

video必须

媒体文件id

thumb_media_id

video必须

music非必须

媒体文件id

title



消息标题

description



消息描述

url



点击链接跳转地址

picurl



图片链接,支持JPG、PNG格式,较好的效果为大图640*320,小图80*80

musicurl



音乐链接

hqmusicurl



高品质音乐链接,wifi环境优先使用该链接播放音乐

请求示例

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返回结果:

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

错误的Json返回示例:

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

统一返回码说明

媒体文件发送接口

接口说明

使用/media/upload和/message/send的接口,发送媒体文件一步到位

请求说明

http请求方式: POST/FORMhttp://api.weixin.qq.com/cgi-bin/media/send?access_token=ACCESS_TOKEN&type=TYPE&touser=OPENID

参数说明

参数

是否必须

说明

access_token



调用接口凭证

type



媒体文件类型

touser



普通用户OPENID

请求示例

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返回结果:

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

错误的Json返回示例:

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

统一返回码说明

拉取关注接口

接口说明

拉取公众账户关注用户列表

请求说明

http请求方式: GEThttps://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID

参数说明

参数

是否必须

说明

access_token



调用接口凭证

next_openid



获取关注用户列表偏移量,不填默认从头开始拉取

返回说明

正确的Json返回结果:

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

参数

说明

total

关注该公众账号的总用户数

count

拉取的OPENID个数,最大值为10000

data

列表数据,OPENID的列表

next_openid

下一次拉取的关注用户的偏移值

错误的Json返回示例:

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

统一返回码说明

注意事项

若公众账号关注人数超过10000,则可以通过填写next_openid的值获取 例子:

公众账号A拥有23000个关注的人,想通过拉取关注接口获取所有关注的人,那么分别请求url如下:https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN 返回结果:{ "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返回结果:{ "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返回结果:{ "total":23000, "count":3000, "data":{" "openid":[ "OPENID20001", "OPENID20002", ..., "OPENID23000" ] }, "next_openid":"NEXT_OPENID3"}



penghu20

等1人赞过



CATEGORIES

IT漫话

生活的点滴

  

爱华网本文地址 » http://www.413yy.cn/a/25101011/61151.html

更多阅读

微信公众平台自定义回复如何制作 公众号自定义回复

微信公众平台自定义回复如何制作——简介微信公众平台现阶段是通过网页端进行一些设置,可实现一些自动回复等一些功能。下面介绍其自动回复功能如何使用。微信公众平台自定义回复如何制作——方法/步骤微信公众平台自定义回复如何制

微信公众平台发起投票功能怎么设置 微信公众号发起的投票

微信公众平台发起投票功能怎么设置——简介微信公众平台发起投票功能怎么设置_投票平台微信公众平台发起投票功能怎么设置 4、在标题栏填写=》【文本标题】=》【名称】微信公众平台发起投票功能怎么设置 5、点击=》【上传封面】(PS

微信公众平台怎么用? 精 微信公众平台怎么推广

微信公众平台怎么用? 精——简介微信公众平台是腾讯公司在微信的基础上新增的功能模块,那么微信平台怎么用?怎么注册和登录呢?微信公众平台里面还有自动回复、开发平台、认证等功能。 这些有的可能都不知道怎么去弄!这里就来为大家分享下

声明:《微信公众平台关于消息接口的内部资料外界暂无流通 公众流通股》为网友忘儘偂塵路分享!如侵犯到您的合法权益请联系我们删除