在申请到认证公众号之前,你可以先通过测试号申请系统,快速申请一个接口测试号,立即开始接口测试开发。
在开发过程中,可以使用接口调试工具来在线调试某些接口。
每个接口都有每日接口调用频次限制,可以在公众平台官网-开发者中心处查看具体频次。
在开发出现问题时,可以通过接口调用的返回码,以及报警排查指引(在公众平台官网-开发者中心处可以设置接口报警),来发现和解决问题。
公众平台以access_token为接口调用凭据,来调用接口,所有接口的调用需要先获取access_token,access_token在2小时内有效,过期需要重新获取,但1天内获取次数有限,开发者需自行存储,详见获取接口调用凭据(access_token)文档。
公众号主要通过公众号消息会话和公众号内网页来为用户提供服务的,下面分别介绍这两种情况:
1)群发消息:公众号可以以一定频次(订阅号为每天1次,服务号为每月4次),向用户群发消息,包括文字消息、图文消息、图片、视频、语音等。
3)客服消息:用户在公众号内发消息/触发特定行为后,公众号可以给用户发消息。
4)模板消息:在需要对用户发送服务通知(如刷卡提醒、服务预约成功通知等)时,公众号可以用特定内容模板,主动向用户发送消息。
许多复杂的业务场景,需要通过网页形式来提供服务,这时需要用到:
公众平台技术文档的目的是为了简明扼要的说明接口的使用,语句难免苦涩难懂,甚至对于不同的读者,有语意歧义。万事皆是入门难,对于刚入门的开发者讲,更是难上加难。
这里我们使用natapp作为内网穿透工具。
windows下,直接双击natapp.exe即可。在Linux/Mac下需要先给执行权限
chmoda+xnatapp然后再运行:windows,点击开始->运行->命令行提示符后进入natapp.exe的目录运行
natapp-authtoken=9ab6b9040a624f40linux,同样给予可执行权限之后,运行
./natapp-authtoken=9ab6b9040a624f40注意参数输入正确性,不要有多余的空格等!
检验signature的Java示例代码:
请注意:
关于重试的消息排重,推荐使用msgid排重。
如果开发者需要对用户消息在5秒内立即做出回应,即使用“发送消息-被动回复消息”接口向用户被动回复消息时,可以在
公众平台官网的开发者中心处设置消息加密。开启加密后,用户发来的消息和开发者回复的消息都会被加密(但开发者通过客服接口等API调用形式向用户发送消息,则不受影响)。关于消息加解密的详细说明,请见“发送消息-被动回复消息加解密说明”。各消息类型的推送XML数据包结构如下:
公众平台的API调用所需的access_token的使用及生成方式说明:
1)建议公众号开发者使用中控服务器统一获取和刷新access_token,其他业务逻辑服务器所使用的access_token均来自于该中控服务器,不应该各自去刷新,否则容易造成冲突,导致access_token覆盖而影响业务;
自定义菜单最多包括3个一级菜单,每个一级菜单最多包含5个二级菜单。
一级菜单最多4个汉字,二级菜单最多8个汉字,多出来的部分将会以“...”代替。
自定义菜单接口可实现多种类型按钮,如下:
article_view_limited:类似view_limited,但不使用media_id而使用article_id
注意:草稿接口灰度完成后,将不再支持图文信息类型的media_id和view_limited,有需要的,请使用article_id和article_view_limited代替
接口调用请求说明
click和view的请求示例
返回结果
正确时的返回JSON数据包如下:
{"errcode":0,"errmsg":"ok"}错误时的返回JSON数据包如下(示例为无效菜单名长度):
关于使用规则,请注意:
所有服务号都可以在功能->添加功能插件处看到申请模板消息功能的入口,但只有认证后的服务号才可以申请模板消息的使用权限并获得该权限;
需要选择公众账号服务所处的2个行业,每月可更改1次所选行业;
在所选择行业的模板库中选用已有的模板进行调用;
每个账号可以同时使用25个模板。
关于接口文档,请注意:
模板消息调用时主要需要模板ID和模板中各参数的赋值内容;
模板中参数内容必须以".DATA"结尾,否则视为保留字;
模板保留符号""。
POST数据说明
POST数据示例如下:
{"industry_id1":"1","industry_id2":"4"}参数说明
返回码说明
在调用模板消息接口后,会返回JSON数据包。正常时的返回JSON数据包示例:
{"errcode":0,"errmsg":"ok","msgid":200228332}使用效果
公众号经常有需要用到一些临时性的多媒体素材的场景,例如在使用接口特别是发送消息时,对多媒体文件、多媒体消息的获取和调用等操作,是通过media_id来进行的。素材管理接口对所有认证的订阅号和服务号开放。通过本接口,公众号可以新增临时素材(即上传临时多媒体文件)。