获取订单
<p><strong>简要描述:</strong> </p>
<ul>
<li>获取订单接口,当前接口暂不支持多面值,多运营商,多省份抢单</li>
</ul>
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>/supplyOrder/snatch</code></li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>POST</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>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">keyword</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户名</td>
</tr>
<tr>
<td style="text-align: left;">timeStamp</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>当前时间戳(毫秒,与平台服务器时间不可相差超过 5 分钟)</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>请求签名</td>
</tr>
<tr>
<td style="text-align: left;">carrier</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>运营商标识码(参考下面运营商说明) ,不传则任意</td>
</tr>
<tr>
<td style="text-align: left;">nominal</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>做单面值</td>
</tr>
<tr>
<td style="text-align: left;">snatchSize</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>抢单数量(1~10单)</td>
</tr>
<tr>
<td style="text-align: left;">version</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>接口版本号(必带,请填写<code>1.1</code>)</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>订单类型(1是快充,2是慢充)</td>
</tr>
<tr>
<td style="text-align: left;">province</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>省份编号(用于筛选地区,参考下面省份说明)</td>
</tr>
<tr>
<td style="text-align: left;">productGroupId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>产品组编号。请联系客服获取</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code>示例1.
{
"code": "OK",
"desc": "正常",
"body": [{
"orderId": "20181023100847537694351",
"regionInfo": "黑龙江 哈尔滨",
"carrier": "移动",
"telephone": "13613633236",
"nominal": 300,
"type": 1,
"state": "REQUIRE",
"stateDesc": "需要缴费",
"sellingPrice": "300.00",
"snatchTime": "2018-10-23 10:08:47",
"expiryTime": 1540260827517
}],
"errDetail": {}
}
示例2.
{
"code": "ERR_NON_EXIST",
"desc": "没有可抢订单",
"body": null,
"errDetail": {}
}
示例3.
{
"code": "ERR_NON_EXIST",
"desc": "没有抢到订单",
"body": null,
"errDetail": {}
}</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;">code</td>
<td style="text-align: left;">string</td>
<td>状态码</td>
</tr>
<tr>
<td style="text-align: left;">desc</td>
<td style="text-align: left;">string</td>
<td>描述信息</td>
</tr>
<tr>
<td style="text-align: left;">body</td>
<td style="text-align: left;">List<Map<string,object>></td>
<td>响应结果体</td>
</tr>
<tr>
<td style="text-align: left;">orderId</td>
<td style="text-align: left;">string</td>
<td>订单编号</td>
</tr>
<tr>
<td style="text-align: left;">regionInfo</td>
<td style="text-align: left;">string</td>
<td>号码信息</td>
</tr>
<tr>
<td style="text-align: left;">carrier</td>
<td style="text-align: left;">string</td>
<td>号码归属地</td>
</tr>
<tr>
<td style="text-align: left;">telephone</td>
<td style="text-align: left;">string</td>
<td>充值号码</td>
</tr>
<tr>
<td style="text-align: left;">nominal</td>
<td style="text-align: left;">int</td>
<td>面值</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">int</td>
<td>订单类型</td>
</tr>
<tr>
<td style="text-align: left;">state</td>
<td style="text-align: left;">string</td>
<td>订单状态</td>
</tr>
<tr>
<td style="text-align: left;">stateDesc</td>
<td style="text-align: left;">string</td>
<td>订单状态描述</td>
</tr>
<tr>
<td style="text-align: left;">sellingPrice</td>
<td style="text-align: left;">string</td>
<td>供货价格</td>
</tr>
<tr>
<td style="text-align: left;">snatchTime</td>
<td style="text-align: left;">string</td>
<td>获取订单时间</td>
</tr>
<tr>
<td style="text-align: left;">expiryTime</td>
<td style="text-align: left;">long</td>
<td>订单超时时间(毫秒数)</td>
</tr>
<tr>
<td style="text-align: left;">errDetail</td>
<td style="text-align: left;">Map<string,object></td>
<td>错误描述对象</td>
</tr>
</tbody>
</table>
<p><strong>备注</strong> </p>
<ul>
<li>运营商说明
移动 ----> MOBILE
联通 ----> UNICOM
电信 ----> TELECOM</li>
</ul>
<p><strong>省份说明:</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">省份编码</th>
<th style="text-align: left;">省份说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">110000</td>
<td style="text-align: left;">北京市</td>
</tr>
<tr>
<td style="text-align: left;">120000</td>
<td style="text-align: left;">天津市</td>
</tr>
<tr>
<td style="text-align: left;">130000</td>
<td style="text-align: left;">河北省</td>
</tr>
<tr>
<td style="text-align: left;">140000</td>
<td style="text-align: left;">山西省</td>
</tr>
<tr>
<td style="text-align: left;">150000</td>
<td style="text-align: left;">内蒙古自治区</td>
</tr>
<tr>
<td style="text-align: left;">210000</td>
<td style="text-align: left;">辽宁省</td>
</tr>
<tr>
<td style="text-align: left;">220000</td>
<td style="text-align: left;">吉林省</td>
</tr>
<tr>
<td style="text-align: left;">230000</td>
<td style="text-align: left;">黑龙江省</td>
</tr>
<tr>
<td style="text-align: left;">310000</td>
<td style="text-align: left;">上海市</td>
</tr>
<tr>
<td style="text-align: left;">320000</td>
<td style="text-align: left;">江苏省</td>
</tr>
<tr>
<td style="text-align: left;">330000</td>
<td style="text-align: left;">浙江省</td>
</tr>
<tr>
<td style="text-align: left;">340000</td>
<td style="text-align: left;">安徽省</td>
</tr>
<tr>
<td style="text-align: left;">350000</td>
<td style="text-align: left;">福建省</td>
</tr>
<tr>
<td style="text-align: left;">360000</td>
<td style="text-align: left;">江西省</td>
</tr>
<tr>
<td style="text-align: left;">370000</td>
<td style="text-align: left;">山东省</td>
</tr>
<tr>
<td style="text-align: left;">410000</td>
<td style="text-align: left;">河南省</td>
</tr>
<tr>
<td style="text-align: left;">420000</td>
<td style="text-align: left;">湖北省</td>
</tr>
<tr>
<td style="text-align: left;">430000</td>
<td style="text-align: left;">湖南省</td>
</tr>
<tr>
<td style="text-align: left;">440000</td>
<td style="text-align: left;">广东省</td>
</tr>
<tr>
<td style="text-align: left;">450000</td>
<td style="text-align: left;">广西壮族自治区</td>
</tr>
<tr>
<td style="text-align: left;">460000</td>
<td style="text-align: left;">海南省</td>
</tr>
<tr>
<td style="text-align: left;">500000</td>
<td style="text-align: left;">重庆市</td>
</tr>
<tr>
<td style="text-align: left;">510000</td>
<td style="text-align: left;">四川省</td>
</tr>
<tr>
<td style="text-align: left;">520000</td>
<td style="text-align: left;">贵州省</td>
</tr>
<tr>
<td style="text-align: left;">530000</td>
<td style="text-align: left;">云南省</td>
</tr>
<tr>
<td style="text-align: left;">540000</td>
<td style="text-align: left;">西藏自治区</td>
</tr>
<tr>
<td style="text-align: left;">610000</td>
<td style="text-align: left;">陕西省</td>
</tr>
<tr>
<td style="text-align: left;">620000</td>
<td style="text-align: left;">甘肃省</td>
</tr>
<tr>
<td style="text-align: left;">630000</td>
<td style="text-align: left;">青海省</td>
</tr>
<tr>
<td style="text-align: left;">640000</td>
<td style="text-align: left;">宁夏回族自治区</td>
</tr>
<tr>
<td style="text-align: left;">650000</td>
<td style="text-align: left;">新疆维吾尔自治区</td>
</tr>
<tr>
<td style="text-align: left;">710000</td>
<td style="text-align: left;">台湾省</td>
</tr>
<tr>
<td style="text-align: left;">810000</td>
<td style="text-align: left;">香港特别行政区</td>
</tr>
<tr>
<td style="text-align: left;">820000</td>
<td style="text-align: left;">澳门特别行政区</td>
</tr>
</tbody>
</table>
<hr />
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>