使用公众平台接口进行开发Word下载.docx

使用公众平台接口进行开发Word下载.docx

《使用公众平台接口进行开发Word下载.docx》由会员分享，可在线阅读，更多相关《使用公众平台接口进行开发Word下载.docx（18页珍藏版）》请在冰点文库上搜索。

描述

signature

微信加密签名

timestamp

时间戳

nonce

随机数

echostr

随机字符串

开发者通过检验signature对请求进行校验（下面有校验方式）。

若确认此次GET请求来自微信服务器，请原样返回echostr参数内容，则接入生效，否则接入失败。

signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数。

加密/校验流程：

1.将token、timestamp、nonce三个参数进行字典序排序

2.将三个参数字符串拼接成一个字符串进行sha1加密

3.开发者获得加密后的字符串可与signature对比，标识该请求来源于微信

消息推送

当普通微信用户向公众账号发消息时，微信服务器将POST该消息到填写的URL上。

结构如下：

文本消息

<

xml>

ToUserName>

<

!

[CDATA[toUser]]>

/ToUserName>

FromUserName>

[CDATA[fromUser]]>

/FromUserName>

CreateTime>

1348831860<

/CreateTime>

MsgType>

[CDATA[text]]>

/MsgType>

Content>

[CDATA[thisisatest]]>

/Content>

MsgId>

1234567890123456<

/MsgId>

/xml>

ToUserName

开发者微信号

FromUserName

发送方帐号（一个OpenID）

CreateTime

消息创建时间（整型）

MsgType

text

Content

文本消息内容

MsgId

消息id，64位整型

图片消息

[CDATA[image]]>

PicUrl>

[CDATA[thisisaurl]]>

/PicUrl>

image

PicUrl

图片链接

地理位置消息

1351776360<

[CDATA[location]]>

Location_X>

23.134521<

/Location_X>

Location_Y>

113.358803<

/Location_Y>

Scale>

20<

/Scale>

Label>

[CDATA[位置信息]]>

/Label>

location

Location_X

地理位置纬度

Location_Y

地理位置经度

Scale

地图缩放大小

Label

地理位置信息

链接消息

[CDATA[link]]>

Title>

[CDATA[公众平台官网链接]]>

/Title>

Description>

/Description>

Url>

[CDATA[url]]>

/Url>

接收方微信号

发送方微信号，若为普通用户，则是一个OpenID

消息创建时间

消息类型，link

Title

消息标题

Description

消息描述

Url

消息链接

事件推送

事件推送只支持微信4.5版本，目前开启自定义菜单接口事件推送、关注与取消关注事件推送。

其余功能即将开放，敬请期待。

[CDATA[FromUser]]>

123456789<

[CDATA[event]]>

Event>

[CDATA[EVENT]]>

/Event>

EventKey>

[CDATA[EVENTKEY]]>

/EventKey>

消息类型，event

Event

事件类型，subscribe（订阅）、unsubscribe（取消订阅）、CLICK（自定义菜单点击事件）

EventKey

事件KEY值，与自定义菜单接口中KEY值对应

消息回复

对于每一个POST请求，开发者在响应包中返回特定xml结构，对该消息进行响应（现支持回复文本、图文、语音、视频、音乐和对收到的消息进行星标操作）。

微信服务器在五秒内收不到响应会断掉连接。

回复xml结构如下：

回复文本消息

12345678<

[CDATA[content]]>

FuncFlag>

0<

/FuncFlag>

接收方帐号（收到的OpenID）

回复的消息内容,长度不超过2048字节

FuncFlag

位0x0001被标志时，星标刚收到的消息。

回复音乐消息

[CDATA[music]]>

Music>

[CDATA[TITLE]]>

[CDATA[DESCRIPTION]]>

MusicUrl>

[CDATA[MUSIC_Url]]>

/MusicUrl>

HQMusicUrl>

[CDATA[HQ_MUSIC_Url]]>

/HQMusicUrl>

/Music>

music

MusicUrl

音乐链接

HQMusicUrl

高质量音乐链接，WIFI环境优先使用该链接播放音乐

回复图文消息

[CDATA[news]]>

ArticleCount>

2<

/ArticleCount>

Articles>

item>

[CDATA[title1]]>

[CDATA[description1]]>

[CDATA[picurl]]>

/item>

[CDATA[title]]>

[CDATA[description]]>

/Articles>

1<

news

ArticleCount

图文消息个数，限制为10条以内

Articles

多条图文消息信息，默认第一个item为大图

图文消息标题

图文消息描述

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

点击图文消息跳转链接

注意事项

1.用户OpenID对一个公众号是固定唯一的串

2.请使用80端口

示例代码

PHP：

下载

通用接口文档

通用接口是使用HTTP请求，让开发者直接与微信服务器交互，实现媒体文件上传、媒体文件获取等功能，达到获取图片、语音、视频等媒体文件的目的。

调用接口所需要的access_token必须通过获取凭证接口获取。

获取凭证

接口说明

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

1.拥有一个微信公众账号，并获取到appid和appsecret（在公众平台申请内测资格，审核通过后可获得）

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

注意：

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

access_token对应于公众号是全局唯一的票据，重复获取将导致上次获取的access_token失效。

请求说明

http请求方式:

GET

参数说明

是否必须

说明

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"

invalidappid"

}

统一返回码说明

自定义菜单接口

∙2菜单创建

∙3菜单查询

∙4菜单删除

开发者获取使用凭证（如何获取凭证）后，可以使用该凭证对公众账号的自定义菜单进行创建、查询和删除等操作。

自定义菜单接口可实现以下类型按钮：

click（点击事件）：

用户点击click类型按钮后，微信服务器会通过消息接口（event类型）推送点击事件给开发者，并且带上按钮中开发者填写的key值，开发者可以通过自定义的key值进行消息回复。

创建自定义菜单后，由于微信客户端缓存，需要24小时微信客户端才会展现出来。

建议测试时可以尝试取消关注公众账号后，再次关注，则可以看到创建后的效果。

菜单创建

通过POST一个特定结构体，实现在微信客户端创建自定义菜单。

http请求方式：

POST

请求示例

{

"

button"

[

{

type"

click"

name"

今日歌曲"

key"

V1001_TODAY_MUSIC"

},

歌手简介"

V1001_TODAY_SINGER"

菜单"

sub_button"

helloword"

V1001_HELLO_WORLD"

赞一下我们"

V1001_GOOD"

}]

}

创建后效果:

button

按钮数组，按钮个数应为2~3个

sub_button

否

子按钮数组，按钮个数应为2~5个

type

按钮类型，目前有click类型

name

按钮描述，既按钮名字，不超过16个字节，子菜单不超过40个字节

key

类型为click必须

按钮KEY值，用于消息接口（event类型）推送，不超过128字节

0,"

ok"

错误的Json返回结果

40018,"

invalidbuttonnamesize"

菜单查询

查询当前使用的自定义菜单结构。

GET

对应创建接口，正确的Json返回结果:

menu"

[{"

[]},{"

[]}]}]}}

菜单删除

取消当前使用的自定义菜单。

接口权限

请先确保公众账号已经拥有接口调用权限。

默认每个公众帐号都不能超过下面的频率限制。

当超出调用接口频率限制，调用对应接口将会收到如下错误信息：

45009,"

apifreqoutoflimit"

接口调用频率限制

接口名称

频率限制

获取凭证接口

200（次/天）

自定义菜单创建接口

100（次/天）

自定义菜单查询接口

1000（次/天）

自定义菜单删除接口