小荔枝开放平台

小荔枝开放平台


2、直接下单

<p>[TOC]</p> <h5>简要描述</h5> <ul> <li>直接下单</li> </ul> <h5>请求URL</h5> <ul> <li><code>/api/order/orderDirectly</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST </li> <li>application/json</li> <li>需要传递 Bearer Token</li> </ul> <h5>参数</h5> <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;">timestamp</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Number</td> <td>10位数时间戳(备注:此参数在Headers里传入,非必填)</td> </tr> <tr> <td style="text-align: left;">logisticsType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">Number</td> <td>物流类型(京东:20001,顺丰:20002)</td> </tr> <tr> <td style="text-align: left;">originId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>第三方单号</td> </tr> <tr> <td style="text-align: left;">sender</td> <td style="text-align: left;">是</td> <td style="text-align: left;">object</td> <td>寄件方信息</td> </tr> <tr> <td style="text-align: left;">- sender.province</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>省</td> </tr> <tr> <td style="text-align: left;">- sender.city</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>市</td> </tr> <tr> <td style="text-align: left;">- sender.district</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>区</td> </tr> <tr> <td style="text-align: left;">- sender.address</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>详细地址(不带省市区)</td> </tr> <tr> <td style="text-align: left;">- sender.name</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>姓名</td> </tr> <tr> <td style="text-align: left;">- sender.mobile</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>联系方式</td> </tr> <tr> <td style="text-align: left;">receive</td> <td style="text-align: left;">是</td> <td style="text-align: left;">object</td> <td>收件方信息</td> </tr> <tr> <td style="text-align: left;">- receive.province</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>省</td> </tr> <tr> <td style="text-align: left;">- receive.city</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>市</td> </tr> <tr> <td style="text-align: left;">- receive.district</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>区</td> </tr> <tr> <td style="text-align: left;">- receive.address</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>详细地址(不带省市区)</td> </tr> <tr> <td style="text-align: left;">- receive.name</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>姓名</td> </tr> <tr> <td style="text-align: left;">- receive.mobile</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>联系方式</td> </tr> <tr> <td style="text-align: left;">payType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">Number</td> <td>固定值:101</td> </tr> <tr> <td style="text-align: left;">goodsType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>物品类型(手机,电脑等,自定义字符串)</td> </tr> <tr> <td style="text-align: left;">subscribeType</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>预约类型 0实时订单 1预约取件时间</td> </tr> <tr> <td style="text-align: left;">subscribeTime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>预约开始时间 (SubscribeType=1时必填) (须大于等于当前时间,格式为:2024-10-25 10:00:00)</td> </tr> <tr> <td style="text-align: left;">subscribeEndTime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>预约结束时间(SubscribeType=1时必填) (须大于subscribeTime一小时以上,格式为:2024-10-25 11:00:00)</td> </tr> <tr> <td style="text-align: left;">isPickupCode</td> <td style="text-align: left;">否</td> <td style="text-align: left;">boolean</td> <td>是否需要揽收验证(默认false)</td> </tr> <tr> <td style="text-align: left;">productList</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Array&lt;object&gt;</td> <td>物品明细(isPickupCode为true时,必填)</td> </tr> <tr> <td style="text-align: left;">- productList.productName</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>物品名称</td> </tr> <tr> <td style="text-align: left;">- productList.code</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>揽收验证码(如手机的背贴码)</td> </tr> <tr> <td style="text-align: left;">note</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>备注</td> </tr> </tbody> </table> <h5>请求示例</h5> <pre><code> { &amp;quot;logisticsType&amp;quot;: 20001, &amp;quot;sender&amp;quot;: { &amp;quot;province&amp;quot;: &amp;quot;四川省&amp;quot;, &amp;quot;city&amp;quot;: &amp;quot;成都市&amp;quot;, &amp;quot;district&amp;quot;: &amp;quot;青羊区&amp;quot;, &amp;quot;address&amp;quot;: &amp;quot;红星路一段86号远鸿同创汇220-1&amp;quot;, &amp;quot;name&amp;quot;: &amp;quot;朱&amp;quot;, &amp;quot;mobile&amp;quot;: &amp;quot;18211111111&amp;quot; }, &amp;quot;receive&amp;quot;: { &amp;quot;province&amp;quot;: &amp;quot;四川省&amp;quot;, &amp;quot;city&amp;quot;: &amp;quot;成都市&amp;quot;, &amp;quot;district&amp;quot;: &amp;quot;青羊区&amp;quot;, &amp;quot;address&amp;quot;: &amp;quot;成都赛格广场(太升南路店) &amp;quot;, &amp;quot;name&amp;quot;: &amp;quot;朱&amp;quot;, &amp;quot;mobile&amp;quot;: &amp;quot;18211111111&amp;quot; }, &amp;quot;subscribeType&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;goodsType&amp;quot;: &amp;quot;文件&amp;quot;, &amp;quot;subscribeTime&amp;quot;: &amp;quot;2024-08-08 17:00:00&amp;quot;, &amp;quot;subscribeEndTime&amp;quot;:&amp;quot;2024-08-08 18:00:00&amp;quot;, &amp;quot;productList&amp;quot;:[ { &amp;quot;productName&amp;quot;:&amp;quot;华为Meta60 蓝色&amp;quot;, &amp;quot;code&amp;quot;:&amp;quot;680053&amp;quot; }, { &amp;quot;productName&amp;quot;:&amp;quot;华为Meta60 白色&amp;quot;, &amp;quot;code&amp;quot;:&amp;quot;680058&amp;#039; }, ], &amp;quot;note&amp;quot;: &amp;quot;测试单&amp;quot; }</code></pre> <h5>返回参数说明</h5> <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;">result</td> <td style="text-align: left;">object</td> <td>响应数据</td> </tr> <tr> <td style="text-align: left;">result.orderNumber</td> <td style="text-align: left;">string</td> <td>鼎霖平台订单号</td> </tr> <tr> <td style="text-align: left;">result.waybillNumber</td> <td style="text-align: left;">Number</td> <td>运单号(顺丰、京东等官方单号)</td> </tr> <tr> <td style="text-align: left;">result.orderTime</td> <td style="text-align: left;">string</td> <td>订单创建时间</td> </tr> <tr> <td style="text-align: left;">isSuccess</td> <td style="text-align: left;">boolean</td> <td>是否成功</td> </tr> <tr> <td style="text-align: left;">operationDesc</td> <td style="text-align: left;">string</td> <td>描述</td> </tr> <tr> <td style="text-align: left;">resultCode</td> <td style="text-align: left;">Number</td> <td>请求状态 0正常 ,其他异常</td> </tr> </tbody> </table> <h5>返回示例</h5> <pre><code> { &amp;quot;result&amp;quot;: { &amp;quot;orderNumber&amp;quot;: &amp;quot;d8644357-d5fd-4a09-963b-de90d8019590&amp;quot;, &amp;quot;waybillNumber&amp;quot;: &amp;quot;JDX030417713393&amp;quot;, &amp;quot;orderTime&amp;quot;: &amp;quot;2024-08-08 14:49:28&amp;quot; }, &amp;quot;isSuccess&amp;quot;: true, &amp;quot;operationDesc&amp;quot;: &amp;quot;下单成功&amp;quot;, &amp;quot;resultCode&amp;quot;: 0 }``` ##### 备注 - 无</code></pre>

页面列表

ITEM_HTML