微信公众平台关于消息接口的内部资料外界暂无流通 公众流通股
情殇影魂 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漫话
生活的点滴
更多阅读
微信公众平台自定义回复如何制作 公众号自定义回复
微信公众平台自定义回复如何制作——简介微信公众平台现阶段是通过网页端进行一些设置,可实现一些自动回复等一些功能。下面介绍其自动回复功能如何使用。微信公众平台自定义回复如何制作——方法/步骤微信公众平台自定义回复如何制
微信公众平台发起投票功能怎么设置 微信公众号发起的投票
微信公众平台发起投票功能怎么设置——简介微信公众平台发起投票功能怎么设置_投票平台微信公众平台发起投票功能怎么设置 4、在标题栏填写=》【文本标题】=》【名称】微信公众平台发起投票功能怎么设置 5、点击=》【上传封面】(PS
如何创建微信公众平台并实现智能化问答? 售后服务实现智能化
如何创建微信公众平台并实现智能化问答?——简介注册微信公众平台并借助V5KF_永久在线的免费智能客服系统 实现智能化问答。比如实现天气,笑话,美食,住宿旅游等智能化问答。 (初学者很适合,简单易行)如何创建微信公众平台并实现智能化问
微信公众平台服务号与订阅号区别详解有图 qq公众平台订阅号
微信公众平台服务号与订阅号区别详解【有图】——简介微信公众平台服务号与订阅号区别详解【有图】_微信订阅号微信公众平台服务号与订阅号区别详解【有图】 3、微信公
微信公众平台怎么用? 精 微信公众平台怎么推广
微信公众平台怎么用? 精——简介微信公众平台是腾讯公司在微信的基础上新增的功能模块,那么微信平台怎么用?怎么注册和登录呢?微信公众平台里面还有自动回复、开发平台、认证等功能。 这些有的可能都不知道怎么去弄!这里就来为大家分享下