订单接口
<p><strong>简要描述:</strong></p>
<ul>
<li>拉取美团外卖订单</li>
<li>必应鸟每5分钟更新一次订单</li>
<li>请求成功errCode为0,请求失败errCode为-1</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>参数:</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;">sign</td>
<td style="text-align: left;">query</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>APP签名</td>
</tr>
<tr>
<td style="text-align: left;">t</td>
<td style="text-align: left;">query</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</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>2</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是更新时间,建议每30分钟同步近2小时的订单,以订单号为唯一标识,判断返回的订单号是否存在,不存在则保存,存在则覆盖原来的订单数据</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" => "app_test",
"type" => 4,
"stime" => "2019-09-05",
"etime" => "2019-09-06"
];
ksort($params);
//5330bd5ed8937dd83746bc70fd6413f3app_test2019-09-062019-09-0545330bd5ed8937dd83746bc70fd6413f3
$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>2-美团外卖</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时,都没有佣金。状态4为美团点评官方接口返回的结果,原因可能是店铺没有参加cps营销等</li>
<li>status=10时,有佣金。每月10号左右会将上个月(use_time)状态为0的订单变成10。</li>
</ul>