3.1 主动通知接口

### 1、通知地址 当有新数据或订单状态变化时,会发送 (POST)请求到合作用户平台请求处理 合作用户在镖局物流平台填写通知地址 例如: ``` https://www.myapp.com/receive ``` ### 2、镖局物流通知参数 - 通知内容(Json 格式 BASE64 加密) - base64_encode(json_encode(xxx)) - 字段 | 字段名称 | 字段类型 | 默认值 | 必填 | 备注 | | ------ | --------| ----- | ----| -----| | notify | string | | true |通知类型,可选参数如下<br>[orderChange]<br> orderChange 订单更新触发通知,<br>当有待处理订单提交到镖局物流平时,触发此通知。<br>通知时返回以下参数orderInfo,为镖局物流订单号集合 | | timestamp | int | | true |当前 Unix 时间戳,10 位整型数字 | | sign | string | | true |通知密钥| ### 3、notify 通知内容示例: ```json { "notify":"orderChange", "orderInfo":{ "codes":[ "内部订单号", "内部订单号", ... "内部订单号" ], "count":"返回单号数" } } ``` - sign 通知密钥 sign = md5(notify=通知内容&timestamp=当前Unix 时间戳 apiKey) ### 4、实例 timestamp = "1433139940" apiKey = "6168f305888c3d795e67c6de17bf8a21" //在镖局物流的 apiKey ***注:base64 结果中会出现加号(+)情况。经过网络请求后,导致加号(+)被转为空格,如果验证密钥, 传入的 base64 结果中出现空格,请转回加号*** ``` notify="eyJub3RpZnkiOiJvcmRlckNoYW5nZSIsIm9yZGVySW5mbyI6eyJjb2RlcyI6WyI4OTE1MTY3MDAwMjE3MjMiLCI4OT E1MTY3MDAwMjE3MjIiXSwiY291bnQiOjJ9fQ=="=//BASE64({"notify":"orderChange","orderInfo":{"codes":["891516700021723","891516700021722 "],"count":2}}) ``` ``` sign=md5(notify=eyJub3RpZnkiOiJvcmRlckNoYW5nZSIsIm9yZGVySW5mbyI6eyJjb2RlcyI6WyI4OTE1MTY3MDAwMjE3MjMiLCI4OTE1MTY3MDAwMjE3MjIiXSwiY291bnQiOjJ9fQ==&timestamp=14331399406168f305888c3d795e67c6 de17bf8a21)= 7f326b45af63ba7cfaa6a2af164a525d ``` ``` http://www.myapp.com/receive.php?notify=eyJub3RpZnkiOiJvcmRlckNoYW5nZSIsIm9yZGVySW5mbyI6eyJjb2RlcyI6WyI4OTE1MTY3MDAwMjE3MjMiLCI4OTE1MTY3MDAwMjE3MjIiXSwiY291bnQiOjJ9fQ==&timestamp=1433139940&sign=7f326b45af63ba7cfaa6a2af164a525d ```