获取标签--getLabelUrl

POST

/default/svc/web-service

如果返回的标签链接里面包含&，需要转义成&

请求参数

Body 参数application/xml

reference_no

string

必需

客户单号/运单号/跟踪号

type

integer | null

单号类型

可选

label_type

enum<integer> | enum<null>

可选

标签尺寸，仅对系统自画标签生效

枚举值:

123

默认值:

label_content_type

enum<integer> | enum<null>

可选

标签内容类型，仅对系统自画标签生效

枚举值:

1234567

默认值:

示例

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
    <SOAP-ENV:Body>
        <ns1:callService>
            <paramsJson>
                <![CDATA[
                    {"reference_no":"CR36600006"}
                ]]>
            </paramsJson>
            <appToken>{{appToken}}</appToken>
            <appKey>{{appKey}}</appKey>
            <service>getLabelUrl</service>
        </ns1:callService>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://8.129.234.2:8085/default/svc/web-service' \
--header 'Content-Type: application/xml' \
--data-raw '<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
    <SOAP-ENV:Body>
        <ns1:callService>
            <paramsJson>
                <![CDATA[
                    {"reference_no":"CR36600006"}
                ]]>
            </paramsJson>
            <appToken>a106eb7a118d78f92cabbc91586caa84</appToken>
            <appKey>a106eb7a118d78f92cabbc91586caa8401ac591bb285b42966f035d8d49a7b5c</appKey>
            <service>getLabelUrl</service>
        </ns1:callService>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>'

返回响应

🟢200成功

application/xml

Body

ask

enum<string>

请求结果状态

必需

枚举值:

SuccessFailure

message

string

请求结果提示信息

必需

Error

object

必需

errCode

string

错误信息状态码

必需

errMessage

string

错误信息

必需

type

string

标签文件类型

必需

示例值:

pdf

url

string

标签文件链接

必需

invoiceUrl

string | null

可选

发票文件链接，label_content_type=4时返回

invoiceType

string | null

可选

发票文件类型，label_content_type=4时返回

reference_no

string

请求单号

必需

time_cost(s)

string

耗时，单位秒

必需

示例

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
    <SOAP-ENV:Body>
        <ns1:callServiceResponse>
            <response>{"ask":"Success","message":"Success","Error":{"errCode":"","errMessage":""},"type":"pdf","url":"http:\/\/112.74.74.27:2018\/index\/get-label?code=CR36600006&amp;other=0&amp;sign=1d3a6ead69a82f89","invoiceUrl":["http:\/\/112.74.74.27:2018\/default\/index\/get-invoice-label\/code\/CR36600006\/index\/0\/0.pdf"],"invoiceType":"pdf","reference_no":"CR36600006","time_cost(s)":0.25939989089966}</response>
        </ns1:callServiceResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

🟢200失败

修改于 2025-01-02 02:20:48

获取跟踪号--getTrackNumber

取消订单--cancelOrder