Ever Connect
v1.4.0中文·EN·한국어登录申请接入
发货与物流

上传收件人证件影像 ⚠️ 终端消费者身份证正反面(PII)

POST/api/v1/shipments/identity-documents需要 tokenlogistics:write写操作2 点

上传收件人证件影像 ⚠️ 终端消费者身份证正反面(PII)。默认关闭,需显式申请开通;只透传、不落日志、不进缓存

请求体(JSON)

字段类型说明
front_image 必填string⚠️ 身份证正面影像(base64)。这是终端消费者的敏感个人信息,我们只透传、不落日志、不进缓存。此接口默认关闭,需显式申请。
最长 8000000
back_image 必填string⚠️ 身份证背面影像(base64)。同上。
最长 8000000
shipment_idsarray<string>关联的发货单号数组(选填)。
0–100
recipientobject收件人对象 { name, phone, address, country_code, state, city, postal_code }。country_code 用 AU / CN / NZ;寄澳洲、新西兰时 state / city / postal_code 必填。跨境件电话请带国际区号(如 +61…),地址请含门牌——地址不全是派送失败最常见的原因。
recipient.namestring收件人姓名,写全名(快递面单上打印的就是它)。
最长 128
recipient.phonestring收件人电话。跨境件请带国际区号(如 +61…),否则清关和派送可能联系不上。
最长 64
document_numberstring收件人证件号(选填),清关时核对用。
最长 64

响应

响应信封只看 HTTP 状态码:成功是 2xx,正文 { data: … }(列表另带 page / page_size / has_moretotal_count);失败是 4xx / 5xx,正文 { error: { code, message, hint, request_id, doc_url } }

写操作请带 Idempotency-Key 头(任意唯一串,如 UUID):网络重试不会重复下单。下单默认只建草稿,由人在 ERP 确认后生效。