开发者需要按照如下步骤完成:
专业号平台中填写 URL(服务器地址)、Token(令牌) 和 EncodingAESKey(消息加密密钥)等信息。
开发者提交信息后,小红书服务器将发送 GET 请求到填写的 URL 上,GET 请求携带参数如下表所示:
参数 | 描述 |
---|---|
signature | 小红书加密签名,signature 结合了开发者填写的 token 参数和请求中的 timestamp 参数、nonce 参数 |
timestamp | 时间戳 |
nonce | 随机数 |
echostr | 随机字符串 |
开发者通过检验 signature 对请求进行校验。若确认此次 GET 请求来自小红书服务器,请原样返回 echostr 参数内容,则接入生效,否则接入失败。加密/校验流程如下:
当某些特定的用户操作引发事件推送时(如用户向小程序客服发送消息、小程序的审核消息通知等情况),小红书服务器会将消息(或事件)的数据包以 POST 请求发送到开发者配置的 URL,开发者可以依据自身业务逻辑进行响应。
小红书服务器在将用户的消息发给开发者服务器地址后,在五秒内收不到响应会断掉连接,并且重新发起请求,总共重试三次。如果在调试中,发现用户无法收到响应的消息,可以检查是否消息处理超时。
开发者服务器收到请求必须做出下述回复,这样小红书服务器才不会对此作任何处理,并且不会发起重试,否则,将出现严重的错误提示。详见下面说明: