Skip to content

回调接口规则

按照以下格式提供给众趣方：

提供完整的url，并且拼接上用于校验的参数app_id和app_secret，例如：

https://customer_host.com/api/callback/?app_id=xxx&app_secret=yyy

回调接口需要满足以下规则

回调接口的验签方式：

众趣方调用回调接口的时候，使用接入方提供的两个参数app_id和app_secret以完成校验。

众趣在调用接入方回调接口的时候，按照如下规则生成sign:

sign = MD5(app_id + timestamp + app_secret + callback_id)

其中：

  • callback_id是众趣为每一次回调生成的唯一id。这个值相同则表示这个一次重复的回调。
  • timestamp为每次次调用回调接口时间的时间戳，单位为毫秒

众趣在调用接入方回调接口时，会在url参数中拼接校验用的参数来完成校验，如:

https://customer_host.com/api/callback/?app_id=1345&timestamp=1532059200000&sign=edb7a6c92c4284fb7e825d63e7258b95&callback_id=877602611346546688

接入方接口被调用时，使用相同的方式计算出sign,与url中拼接的参数进行比较完成校验

业务数据格式：

回调接口必须能够处理Content-Type为application/json的请求，具体的业务数据会以json格式包含在post的请求体中，编码格式为utf-8

示例:

POST /test/api/callback/ HTTP/1.1
Content-Type: application/json;charset=utf-8
Content-Length: 10

{"id": 1}
回调接口的响应值

接入方在收到该回调请求，并成功从请求体中读取出业务数据后，必须响应字符串success，表示成功接收到该请求。

如果回调接口响应的结果的不是success,后台服务器会重复进行回调，每次回调间隔为30s,4m,30m,1h,。