当前位置:主页 > 公众服务

融云公众服务开发者文档

2017-12-29 13:30 来源:四川禁毒网

融云公众服务包括:应用公众服务和公众服务平台,它为应用开发者和公众账号运营者提供连接服务。

公众服务平台: 在 App 开发者和公众帐号运营者之间建立对接平台。App 开发者可以通过平台引入公众服务资源,帮助 App 快速覆盖用户需求。公众帐号持有者通过平台有机会向所有集成融云 SDK 的 App 提供服务,进而获得更加精准、丰富的受众渠道。

应用公众服务: 为 App 开发者提供 App 内建公众服务能力。

公众服务平台开发指南 注册公众服务

接入融云公众服务,开发者需要前往融云公众服务注册开发者创建公众号,注册时需提供真实身份信息。融云对提交信息审核成功后,公众号创建成功,即可进行消息推送、回复、粉丝管理等操作。

请注意,如开发者想通过自己的 URL 地址接收用户信息,需要在开发者中心开启开发者模式后,按以下方式进行接入。

公众服务客户端功能接入请参考: 或

接入前准备 获取 RC-PSKey / Secret

创建公众号后会为每个开发者分配对应的 RC-PSKey / Secret , 登录融云公众服务官网后,打开融云公众服务 - 开发者中心页面,获取 RC-PSKey/Secret。

RC-PSKey 公众号 Key 唯一标识,是用于验证 API 接入合法性的。

Secret API 接口密钥,在调用 API 接口生成数据签名时需要用到,可重置重新获取,重置后原密钥失效,需使用新密钥重新生成签名调用 API 接口,建议谨慎操作刷新密钥功能。

image

获取 RC-PSKey / Secret 位置

配置消息接收地址

接入融云公众服务前,开发者需要完成消息接收 URL 配置,公众号接收用户发送的消息以及开发者需要的事件推送,融云会将消息数据包 POST 到开发者设置的消息接收 URL 上。

image

消息接收 URL 位置

消息接收 URL 必须以 开头,目前只支持 80 端口。

API 接口签名规则 API 调用签名规则

本文档中所有请求融云服务端 API 接口的请求均使用此规则校验,以下不再重复说明。

每次请求 API 接口时,均需要提供 4 个 HTTP Request Header,具体如下:

名称 类型 说明
RC-PSKey   String   融云公众服务分配的 Key。  
RC-Nonce   String   随机数,无长度限制。  
RC-Timestamp   String   时间戳,从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到当前时间(北京时间)的毫秒数。(请严格参照此执行,服务器端会校验此信息)  
RC-Signature   String   数据签名。  

RC-Signature (数据签名)计算方法:

将系统分配的 secret、以及 RC-Nonce、RC-Timestamp 三个参数进行字典序排序

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

API 接收签名规则

融云服务器向公众帐号服务器推送数据时会添加 3 个 GET 请求参数(在 URL 上添加的参数),具体如下:

名称 类型 说明
rc-nonce   String   随机数,无长度限制。  
rc-timestamp   String   时间戳,从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到当前时间(北京时间)的毫秒数。  
rc-signature   String   数据签名。  

rc-signature (数据签名)计算方法:

将系统分配的 secret、以及 rc-nonce、rc-timestamp 三个参数进行字典序排序

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

接收消息

当 App 内用户向公众帐号发消息时,融云服务器将 POST 消息数据包(XML格式)到开发者配置的消息接收 URL 上。

融云服务器在五秒内收不到响应会断掉连接,并且重新发起请求,总共重试三次。

关于重试的消息排重,推荐使用 MsgID 排重。

假如开发者服务器无法保证在五秒内处理并回复,可以直接回复空字符串,融云服务器不会对此作任何处理,且不会发起重试。

http 请求方式:POST

请求接收方式:

文本消息格式

XML 格式

<xml> <ToUserName><![CDATA[toUserName]]></ToUserName> <FromUserName><![CDATA[fromUserName]]></FromUserName> <CreateTime>134223445860</CreateTime> <MsgType><![CDATA[text]]></MsgType> <Content><![CDATA[content]]></Content> <MsgId>msgId</MsgID> </xml>



上一篇:2017年《公共服务蓝皮书》指出—— 公共交通成最受关注的民生问题
下一篇:微信公众服务号怎么一天发一条图文消息?