首页 > API文档 > 实名寄递API
是应国家法律法规要求,用户寄快件时需要进行实名登记。快递鸟实名寄递API,提供平台类注册子用户的实名提交入口(包括散户,协议用户),已提交实名信息的快递鸟用户,通过预约取件,电子面单等API提交订单时,将同步实名信息到收件快递员设备上,寄件时可免出示身份证(部分快递)。一次实名,终身有效,所有快递公司通用。提升用户寄件,快递员揽件效率的同时减少隐私信息频繁暴露。
支持同步实名信息的接口:
预约取件接口、电子面单接口、轨迹订阅接口(包含收寄方信息)。支持的快递公司:
安能快递(ANE)、中通快递(ZTO)、国通快递(GTO)、韵达速递(YD)(仅支持预约取件接口)、德邦快递(DBL)(仅支持预约取件接口)、百世快递(HTKY)(仅支持电子面单接口)。支持的快递柜:
丰巢快递柜(FCBOX)(仅支持预约取件接口)。适用于电商平台,ERP系统商,快递发发等平台,提供给注册用户实名认证功能,认证后实名寄件时免出示身份证(快递公司陆续支持)功能包括:
(1)个人用户实名认证。
(2)申请快递公司协议用户(即将上线)。
(3)个人用户,协议用户实名寄件。
一、 请求系统级参数说明:
参数名称 | 类型 | 说明 | 必须要求 |
---|
RequestData | String | 应用级别参数(Json格式)。 | 否 |
EBusinessID | String | 商户ID。 | 是 |
RequestType | String | 请求指令类型:1021 | 是 |
DataSign | String | 数据内容签名。 | 是 |
DataType | String | 请求、返回数据类型: 2-json。 | 是 |
二、应用级输入参数(RequestData)
请求内容字段定义:
参数名称 | 类型 | 说明 | 是否必须 |
---|
MemberID | String | 平台会员ID或ERP商家ID等 | 否 |
Name | String | 姓名 | 是 |
Gender | Int | 性别: 1-男 2-女 | 否 |
TypeOfId | Int | 证件类型:1-身份证 | 是 |
NumberOfId | String | 证件号 | 是 |
Contact | Array | 联系方式,可提交多条
[{“Mobile”:”123”,”Phone”:”123”},{“Mobile”:”1223”,”Phone”:”123”}] | 是 |
Province | String | 地址中的省、自治区或直辖市 | 是 |
City | String | 地址中的市 | 是 |
Address | String | 个人详细地址 | 是 |
CodeOfWeixin | String | 微信号 | 否 |
CollectMethod | Int | 用户信息采集方式 1-身份证件识别设备 2-NFC+SAM方式 3-OCR读取方式 | 是 |
ImageFront | String | 身份证正面照(图片转成base64字符串) | 是 |
ImageBack | String | 身份证反面照(图片转成base64字符串) | 是 |
ImageHand | String | 手持身份证正面照(图片转成base64字符串 | 否 |
UserType | String | 10:个人散件用户,11:个人协议用户,不填默认为10 | 否 |
StoreName | String | 对应的店铺名称,如为个人协议用户,此字段必填。 | 可选 |
返回参数定义:
参数名称 | 类型 | 说明 | 必须要求 |
---|
EBusinessID | String | 电商用户ID | 是 |
Success | Bool | 成功与否 | 是 |
Reason | String | 失败原因 | 否 |
三、示例
{
"MemberID": "",
"Name": "1234567",
"Gender": "2",
"TypeOfId": "1",
"NumberOfId": "420211199901011234",
"Contact": [{
"Mobile": "13500000000",
"Phone": ""
}, {
"Mobile": "15817289472",
"Phone": "07558651234"
}],
"Province": "广东省",
"City": "深圳市",
"Area": "福田区",
"Address": "金花路11号",
"CodeOfWeixin": "",
"CollectMethod": "3",
"ImageFront": "Base64Z",
"ImageBack": "Base64F",
"ImageHand": ""
}
{
"UpdateTime": "2018-02-02 13:59:02",
"EBusinessID": "1261799",
"Success": true
}