PDC

订单快递邮寄资料信息更新

开发中

vgs_dev

https://dapi.visageniusglobal.com

POST

/openvisa/order_express_add

一、鉴权

每个调用方都会得到一个appid、access_key、secret_key，请求时，将：Date、X-Appid、Authorization放到请求头中，其中：

1、Date/X-Date

报文创建的日期和时间（格林尼治标准时间，而不是本地时间），例如：Date: Wed, 21 Oct 2022 07:28:00 GMT。这个时间上下误差不能超过5分钟，否则会报错。

2、X-Appid

我方给的appid

3、Authorization

将access_key、appid、date三个字符串拼接起来，中间以\n分割，例如：

string s = access_key + '\n' + appid + '\n' + date

然后将该字符串做hmac_sha1，得到的结果做base64，

string t = base64(hmac_sha1(secret_key, s))，

最后，Authorization的值如下：

string Authorization = "Basic " + t

请求参数

Header 参数

X-Date

string

可选

示例值:

X-Appid

string

可选

示例值:

Authorization

string

可选

示例值:

Body 参数application/json

order_id

integer

订单id

必需

applicant_id

integer

申请人id

必需

订单第一次添加快递信息可以默认为0，当申请人需要补纸质资料时，需要传申请人id，

express_set

object

必需

tracking_number

string

快递单号

必需

限制20位

express_name

string

快递公司名

必需

可选值：顺丰速运中国邮政EMS 圆通快递申通快递韵达快递中通快递百世汇通宅急送德邦物流国通快递优速物流自取自送

示例

{
    "order_id":1000012397,
    "express_set":{
        "tracking_number":"1543542354326",
        "express_name":"顺丰速运"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://dapi.visageniusglobal.com/openvisa/order_express_add' \
--header 'X-Date: ' \
--header 'X-Appid: ' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "order_id":1000012397,
    "express_set":{
        "tracking_number":"1543542354326",
        "express_name":"顺丰速运"
    }
}'

返回响应

🟢200成功

application/json

Body

ret

integer

状态码

必需

msg

string

描述信息

必需

body

object

必需

示例

{
    "ret": 0,
    "msg": "ok",
    "body": {}
}

🟢200接口异常

🟠400参数不正确

🔴503服务异常

配置获取

商品价格查询

订单快递邮寄资料信息更新

一、鉴权#

1、Date/X-Date#

2、X-Appid#

3、Authorization#

请求参数

示例代码

返回响应

一、鉴权

1、Date/X-Date

2、X-Appid

3、Authorization