海运箱动态推送（单节点）

POST

*推送的API地址是需要贵司提供的，谢谢！

请求参数

Body 参数application/json

keyid

string

主键

可选

调用订阅接口时上传的keyid值

>= 36 字符<= 36 字符

vslname

string

船名

可选

>= 64 字符<= 64 字符

voy

string

航次

可选

>= 32 字符<= 32 字符

blno

string

提单号

必需

>= 32 字符<= 32 字符

ctnrno

string

箱号

必需

>= 11 字符<= 11 字符

statuscd

string

状态代码

可选

>= 16 字符<= 16 字符

statusdesc

string

状态描述

可选

>= 255 字符<= 255 字符

statusdesc_en

string

英文状态描述

可选

>= 255 字符<= 255 字符

statustime

string <date-time>

状态时间

可选

placecd

string

状态地点代码

可选

>= 5 字符<= 5 字符

place

string

状态地点

可选

>= 164 字符<= 164 字符

isest

string

是否预计时间

必需

Y=是，N=否

>= 2 字符<= 2 字符

cancelid

string

无效标识

可选

Y=已退载或甩柜

>= 2 字符<= 2 字符

dbtype

string

数据类型

可选

1=新增；2=修改；3=删除

>= 2 字符<= 2 字符

fkeyid

string

云当业务主键

可选

该字段可忽略

>= 36 字符<= 36 字符

statusplace_cn

string

地点中文名称

可选

暂时为空值，该字段可以忽略

>= 164 字符<= 164 字符

companycd

string

企业编号

必需

暂时为空值，该字段可以忽略

>= 11 字符<= 11 字符

createtime

string <date-time>

最新更新时间

必需

terminalcd

string

码头代码

可选

>= 8 字符<= 8 字符

terminal

string

码头

可选

>= 128 字符<= 128 字符

firmscode

string

地点海关代码

可选

>= 8 字符<= 8 字符

transporter

string

营运人

可选

>= 12 字符<= 12 字符

transportation

string

运输方式

可选

>= 12 字符<= 12 字符

csize

string

尺寸

可选

>= 2 字符<= 2 字符

ctype

string

箱型

可选

>= 2 字符<= 2 字符

sealno

string

铅封号

可选

>= 18 字符<= 18 字符

sourcecd

string

数据来源

必需

1=船东；2=码头；4=云当计算（可以根据贵司的具体业务需求，斟酌该节点是否做更新）

>= 1 字符<= 1 字符

transportationcd

string

运输方式代码

必需

>= 1 字符<= 1 字符

示例

{
    "keyid": "23090016B",
    "fkeyid": "e6029498-e8c3-4966-a363-ecba6ce59397",
    "blno": "003301860072",
    "ctnrno": "TGBU4419731",
    "statuscd": "DSCH",
    "statusdesc": "卸船",
    "statusdesc_en": "Discharged (FCL)",
    "statustime": "2023/9/26 0:00:00",
    "place": "LOS ANGELES, CA (US)",
    "statusplace_cn": null,
    "vslname": "EVER LUCID",
    "voy": "1314-065E",
    "companycd": null,
    "isest": "N",
    "cancelid": null,
    "dbtype": "1",
    "placecd": "USLAX",
    "createtime": "2023/9/27 8:46:22",
    "terminalcd": null,
    "terminal": null,
    "firmscode": null,
    "transporter": "",
    "transportation": null,
    "sealno": "EMCLME1761",
    "csize": "40",
    "ctype": "HQ",
    "sourcecd": "1"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://prod-cn.your-api-server.com' \
--header 'Content-Type: application/json' \
--data-raw '{
    "keyid": "23090016B",
    "fkeyid": "e6029498-e8c3-4966-a363-ecba6ce59397",
    "blno": "003301860072",
    "ctnrno": "TGBU4419731",
    "statuscd": "DSCH",
    "statusdesc": "卸船",
    "statusdesc_en": "Discharged (FCL)",
    "statustime": "2023/9/26 0:00:00",
    "place": "LOS ANGELES, CA (US)",
    "statusplace_cn": null,
    "vslname": "EVER LUCID",
    "voy": "1314-065E",
    "companycd": null,
    "isest": "N",
    "cancelid": null,
    "dbtype": "1",
    "placecd": "USLAX",
    "createtime": "2023/9/27 8:46:22",
    "terminalcd": null,
    "terminal": null,
    "firmscode": null,
    "transporter": "",
    "transportation": null,
    "sealno": "EMCLME1761",
    "csize": "40",
    "ctype": "HQ",
    "sourcecd": "1"
}'

返回响应

🟢200成功

application/json

Body

status

integer

是否成功

必需

0=成功，1=失败

message

string

错误信息

可选

失败时的失败原因

>= 164 字符<= 164 字符

示例

{
    "status": 0,
    "message": "stringstringstringstringstringstringstringstringstringstringstringstringstringstringstringstringstringstringstringstringstringstringstringstringstringstringstringst"
}

海运跟踪下载（按箱号订阅）

集装箱海上轨迹