推送标签

POST

http://prod-cn.your-api-server.com/api/setLabel

20250526版本以上

请求参数

Header 参数

Authorization

string

必需

默认值:

Bearer eyJhbGciOiJIUzUxMiJ9.eyJkYXRlIjoxNzExMjg3NzUyNjE5LCJ0b2tlbiI6IjRlNTQzMDZhNDdhNGY3NGQ0YjZiN2VhOTlmNDZjMDhjIn0.q7cqP3xlSG1xY1WdTGO33u5z0fwpT3pxVeweX6EHgxnZCgtqWUpph6xZn6tt4KjYJoYOvFZ-1tDMbwXtEXDy1w

Body 参数application/json

orderData

object

订单信息

必需

orderNo

string

订单号

可选

与客户参考号二选一提交

customerNo

string

客户参考号

可选

与订单号二选一提交

trackNo

string

物流商单号

必需

物流商单号，针对Y2模式，下单推送服务商单号给系统，系统版本20250526以上

base64Label

string

物流标签

必需

物流标签PDF文件转成的Base64字符串。针对Y2模式，下单推送服务商面单给系统，系统版本20250526以上

示例

{
    "orderData": {
        "orderNo": "ON2312241729000110",
        "customerNo": "customerNo001",
        "trackNo": "test001",
        "base64Label": "JVBERi0xLjQKJ........"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://prod-cn.your-api-server.com/api/setLabel' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "orderData": {
        "orderNo": "ON2312241729000110",
        "customerNo": "customerNo001",
        "trackNo": "test001",
        "base64Label": "JVBERi0xLjQKJ........"
    }
}'

返回响应

🟢200成功

application/json

Body

code

integer

返回状态码

必需

200表示成功，其他表示失败

msg

string

返回提示

必需

示例

{
    "code": 0,
    "msg": "string"
}

修改于 2025-05-26 12:11:15

打印标签

查询轨迹