取号接口
取号接口
1.请求参数:
请求URL:
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| appid | String | 是 | 合作伙伴AppId | |
| timestamp | String | 是 | 1657525936 | 当前Unix时间戳,秒 |
| seller_nick | String | 是 | 38173182 | 店铺账号,对应蜂巢授权返回seller_nick字段 |
| sign | String | 是 |
业务参数
| 参数名称 | 参数类型 | 是否必须 | 参数描述 |
|---|---|---|---|
| brand_code | String | 可选 | 品牌编码,非必填 |
2. 请求示例代码(Java)
@Test
public void WaybillGet() throws Exception {
String reqData ="{\n" + " \"product_code\": \"\",\n" + " \"ownerId\": \"67d39413f596f20015fe0ebe\",\n" + " \"wp_code\": \"shentong\",\n" + " \"sender_province\": \"浙江省\",\n" + " \"sender_city\": \"金华市\",\n" + " \"sender_district\": \"东阳市\",\n" + " \"sender_town\": \"江北街道\",\n" + " \"sender_address\": \"广福西街300号\",\n" + " \"sender_name\": \"陈先\",\n" + " \"sender_mobile\": \"13107821309\",\n" + " \"order_channel\": 1,\n" + " \"wp_type\": 1,\n" + " \"sender_order\": [\n" + " {\n" + " \"order_sn\": \"P769320972163297951\",\n" + " \"receiver_province\": \"浙江省\",\n" + " \"receiver_city\": \"杭州市\",\n" + " \"receiver_district\": \"萧山区\",\n" + " \"receiver_address\": \"**省杭州市萧山区新塘街道融望**\",\n" + " \"reciver_town\": \"新塘街道\",\n" + " \"receiver_name\": \"傅*\",\n" + " \"receiver_mobile\": \"158****2249\",\n" + " \"goods_name\": \"牙线高分子细滑牙线棒\",\n" + " \"goods_count\": \"1\",\n" + " \"oaid\": \"fd4104493a8f3092db4526c40f7660bd\"\n" + " }\n" + " ]\n" + "\n" + "}";
String sellerNick = "xxx";
//业务参
Map<String, String> data = new HashMap();
data.put("appid", Config.AppId);
data.put("seller_nick", sellerNick);
Long timestamp = System.currentTimeMillis();
data.put("timestamp", timestamp.toString());
data.put("request_data", reqData);
// 参数签名
data.put("sign", Utils.Sign(data, Config.AppSecret));
String result = doHttpRequest(apiUrl, data);
System.out.println("result:"+result);
}
3. 返回结果
返回结果如下
{
"code": 0,
"message": "处理成功",
"data": {
"fail": [],
"success": [
{
"print_data": "AES:qYJ1C25/YaQtrt7GcBerPhA+pFaaTy7aqs/kvG/J0cIc66Wtqefr/A+y7p/6oXiAYNzagdn5phVqlpktJQLwSwAHSRcZ8Y8AggkIp0E8ZdxmaQQ0odA8eGyTU+J4cxZU76NTIMeS4IVgk8RcEizyYtTooQZan9/9aVxH+AZPm/sEAIiqvKggUAbdECy4t8JOGy+m5EniABeSUxqFY2GpU9mRZ75An7fokFTHHCHfdVpwFKYGhGAM9tMONF2QSN9ODUt1KZscT81gfC2ltawgp9pM/2JsNnjqy5vBD3HU1F3odpgS75uoc6QEvLX61Ts8ws9M5iySi/VnZLL9T9+dIvltybdANWbWiKh4mCUDv9WqqmhKtE44HO5SsYeHecPOE19MpFLf6cANOihNOLVFFVO3KBjPBrJSfZx07hTrizjGQ6Z64bD64CSGbZPfk5ivEVfBN4Ut87dXPsJIAxgu5QbQEvCxEoYfVoZtX3XKH6IFEDYo67bHCfOEFZOmawPXEWH++UQ2IT5chLTCDNP3VJeVoAhhxSUiy6lgu5duQVnaOdVFmoNEODBXra/rueIvd/iAnmLuMNPV8kC0OPlj2WcyruSnpVG2FnHVkAmAVKJ2xFWuzE5X2rDpzhXeFMdJJjVNmuaD/dUqY4i5/6rjJiM+NrSKni3caHnVQV4cx7rBzdumG9jeSV1/jAaa+JbwtkDWipQcUB0mjSsPr7gsu4YVT328SWL8vQY6oUIfg0npxDeTnq+435jB+g5tFghGeInaXFIc/eQn1+NzVyqQJiPhZldI20gbqEiTzGtVtAiSQGiPXtNcmmueaJp90xsubpBqagPQshS4Ivzxalw2KVrVFtpHr2BZw/8d/adJ0BvX5wJMTsVoCEtF416Tz43o",
"cp_code": "shentong",
"object_id": "P769320972163297951",
"customerPrintData": "",
"waybill_code": "772045592697942",
"template_url": "https://cloudprint.xiaohongshu.com/template/standard/15/1"
}
]
}
}
返回code为0表示成功, 非0为失败,失败时message会有失败原因。
文档更新时间: 2025-12-29 20:26 作者:admin