取号接口

取号接口

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/xhs/waybill/get

参数名称 参数类型 是否必须 示例值 参数描述
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