必应鸟open--本地生活


订单接口

<p><strong>简要描述:</strong></p> <ul> <li>拉取商家券订单</li> <li>必应鸟T+1更新订单</li> <li>请求成功errCode为0,请求失败errCode为-1</li> <li>下单时,只有使用领取的优惠券,才算推广成功,否则,推广失败,订单无法同步,也不计算佣金</li> <li><span style=color:red>测试时,建议等订单同步到之后,再申请退款,否则可能无法同步到订单</span></li> </ul> <p><strong>请求API:</strong> </p> <ul> <li><code>/open/order</code></li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>GET </li> </ul> <p><strong>GET请求参数:</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">位置</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">app_key</td> <td style="text-align: left;">query</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>开放平台获取</td> </tr> <tr> <td style="text-align: left;">page</td> <td style="text-align: left;">query</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>页码默认是1</td> </tr> <tr> <td style="text-align: left;">pageSize</td> <td style="text-align: left;">query</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>每次获取的数据量,默认是20</td> </tr> <tr> <td style="text-align: left;">type</td> <td style="text-align: left;">query</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>4-大众点评商家券 6-美团商家券</td> </tr> <tr> <td style="text-align: left;">stime</td> <td style="text-align: left;">query</td> <td style="text-align: left;">是</td> <td style="text-align: left;">date</td> <td>起始时间,格式:2019-08-24,(默认0点)</td> </tr> <tr> <td style="text-align: left;">etime</td> <td style="text-align: left;">query</td> <td style="text-align: left;">是</td> <td style="text-align: left;">date</td> <td>截止时间,格式:2019-08-24,(默认24点)起止时间差控制在七天内</td> </tr> <tr> <td style="text-align: left;">signature</td> <td style="text-align: left;">query</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>签名,计算方式:参数(除去signature)按照键名升序排序之后将值拼接得到原始串,原始串前后拼接app_secret之后进行SHA256加密得到签名</td> </tr> </tbody> </table> <p><span style="color:red;">注意: 1.etime和stime是更新时间,建议每天20点同步前一天的订单,以订单号为唯一标识,判断返回的订单号是否存在,不存在则保存,存在则覆盖原来的订单数据</span></p> <h4>签名示例:</h4> <p><a href="http://test.wef2.top/open/order?app_key=app_test&type=4&stime=2019-09-05&etime=2019-09-06&signature=7ad7bfb1deb635bb6ed7c0a384ded4871563f1226d9f20775343b7404d6bcb53">http://test.wef2.top/open/order?app_key=app_test&type=4&stime=2019-09-05&etime=2019-09-06&signature=7ad7bfb1deb635bb6ed7c0a384ded4871563f1226d9f20775343b7404d6bcb53</a> </p> <pre><code>针对上面的链接,生成签名: $secret = "5330bd5ed8937dd83746bc70fd6413f3"; $params = [ "app_key" =&gt; "app_test", "type" =&gt; 4, "stime" =&gt; "2019-09-05", "etime" =&gt; "2019-09-06" ]; ksort($params); $origin = $secret.implode("", $params).$secret; $signature = hash("sha256", $origin); //7ad7bfb1deb635bb6ed7c0a384ded4871563f1226d9f20775343b7404d6bcb53 </code></pre> <p><strong>返回示例</strong></p> <pre><code> { "errCode": 0, "msg": "返回成功", "result": { "data": [ { "order_id": "1164364081403097135", "name": "香辣鸡腿堡", "pay_money": 4000, "commission": 120, "predict_commission": 120, "from": 20, "pay_time": "2019-08-21 13:19:03", "status": 10, "use_time": "2019-08-21 13:19:03", "refund_time": null, "created_at": "2019-08-23 14:17:04", "updated_at": "2019-08-23 14:17:04", "open_extra": "vembnk_18" } ], "totalPage": 1 } }</code></pre> <p><strong>返回数据结构</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">totalPage</td> <td style="text-align: left;">int</td> <td>最大page</td> </tr> <tr> <td style="text-align: left;">order_id</td> <td style="text-align: left;">stirng</td> <td>订单号</td> </tr> <tr> <td style="text-align: left;">name</td> <td style="text-align: left;">string</td> <td>商品名称</td> </tr> <tr> <td style="text-align: left;">pay_money</td> <td style="text-align: left;">int</td> <td>付款金额(分)</td> </tr> <tr> <td style="text-align: left;">commission</td> <td style="text-align: left;">int</td> <td>实际佣金金额(分)</td> </tr> <tr> <td style="text-align: left;">predict_commission</td> <td style="text-align: left;">int</td> <td>预估佣金(分)</td> </tr> <tr> <td style="text-align: left;">from</td> <td style="text-align: left;">int</td> <td>4-大众点评商家券 6-美团商家券</td> </tr> <tr> <td style="text-align: left;">pay_time</td> <td style="text-align: left;">string</td> <td>付款时间</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">int</td> <td>订单状态:0:已下单,1:失效 4:不结算 10:成功</td> </tr> <tr> <td style="text-align: left;">use_time</td> <td style="text-align: left;">stirng</td> <td>核销时间</td> </tr> <tr> <td style="text-align: left;">refund_time</td> <td style="text-align: left;">stirng</td> <td>退货时间</td> </tr> <tr> <td style="text-align: left;">created_at</td> <td style="text-align: left;">string</td> <td>创建时间</td> </tr> <tr> <td style="text-align: left;">updated_at</td> <td style="text-align: left;">string</td> <td>更新时间</td> </tr> <tr> <td style="text-align: left;">open_extra</td> <td style="text-align: left;">string</td> <td>自定义参数</td> </tr> </tbody> </table> <p><strong>备注:</strong></p> <ul> <li>status=0/1/4时,都没有佣金。0为中间状态,出现几率较小;4为美团点评官方接口返回的结果,原因可能是店铺没有参加cps营销等</li> <li>status=10时,有佣金。</li> </ul>

页面列表

ITEM_HTML