数供网

一个虚拟货品交易平台


获取订单

<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&lt;Map&lt;string,object&gt;&gt;</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&lt;string,object&gt;</td> <td>错误描述对象</td> </tr> </tbody> </table> <p><strong>备注</strong> </p> <ul> <li>运营商说明 移动 ----&gt; MOBILE 联通 ----&gt; UNICOM 电信 ----&gt; 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>

页面列表

ITEM_HTML