企业🤖AI Agent构建引擎,智能编排和调试,一键部署,支持私有化部署方案 广告
# **大象赋能主动通知接口文档** 版本:V1.0   修改日期:2022/10/15 #### **概述** 当商品,订单,邮寄规则发生变化时,大象赋能将会主动向对接方进行通知,对接方需要提供以下三个接口来接受大象赋能的调用: 1.获取商品变化接口 body 为商品信息即ModelProduct,与对接方主动获取商品详情接口返回的内容一致,接受参数参考地址: http://api.funengscm.com/swagger-ui/#/%E5%95%86%E5%93%81%E6%8E%A5%E5%8F%A3/postDetailsUsingPOST 2.获取订单信息变化接口 body 为订单信息即ModelOrderSub,与对接方主动获取子订单接口返回的内容一致,接受参数参考地址: http://api.funengscm.com/swagger-ui/#/%E8%AE%A2%E5%8D%95%E6%8E%A5%E5%8F%A3/queryOrderSubUsingPOST 3.获取邮寄规则变化接口 body 为邮寄规则即ModelExpressRule,与对接方主动获取邮寄规则接口返回的内容一致,接受参数参考地址: http://api.funengscm.com/swagger-ui/#/%E8%BF%90%E8%B4%B9%E8%A7%84%E5%88%99%E6%8E%A5%E5%8F%A3/getDetailsUsingPOST #### **调用信息** 大象赋能回调消息使用application/json方式调用,消息分为两部分,即http body和http header两部分,body为业务对象,header为签名部分,以java为例,接受的代码入下: Method:POST Http Headers: 1. Content-Type:application/json 1. timestamp:当前毫秒时间戳 1. apiKey:用户APIkey 1. sign:签名 ![](https://img.kancloud.cn/6d/d5/6dd58a1b9b86097e46188abc6e9830a6_756x894.png) #### **签名方式** 大象赋能在回调对接方接口时遵循的签名标准与调用方调能大象赋能接口时标准一致,即将对接方apiKey,timestamp,sign放入header,body为业务对象json,签名方式如下: 1.将除header外的json字符串拼成body=(json)的形式 2.将所有参数按参数名升序排序 3.将参数用\=符号连接参数名和参数值,用&符号连接各参数,字符串尾部拼接&secret=(apiSecret) 4.使用md5 小写32位进行签名 #### **对接方返回信息** 对接方收到大象赋能的通知消息并进行签名验证,处理业务数据后返回字符串success则视为调用成功,如果不返回success或调用时长超过5秒,大象赋能则分别会在1,2,4,8,16分后调用,次数超过5次结束回调通知。