新增外部出行人

请求地址

https://api.es.xiaojukeji.com/open-apis/v1/traveler/create

请求方式

POST

Content-Type: application/json

是否需要登录

是 关于登录授权，参见 如何登录授权

请求参数

名称 类型 必填 示例 描述
client_id string Y 87fca1dde0a96c20fccf2ccaa40_test 申请应用时分配的AppKey
access_token string Y 8d7479966691fccbd6d4f04ed77b61 授权后的access token
详见如何授权
timestamp bigint Y 1689667125 当前时间戳（秒级）
company_id string Y 1125915646167936 滴滴侧公司ID
托管模式下为操作的公司ID，同时需要开启托管的员工管理权限
非托管模式下为自己公司ID
param_json string Y 详见下方 param_json 格式 请求参数
将 param_json 转为 json 字符串
sign string Y 5d3a57a8fd898a9eba1d82a8fc49620b 签名

param_json 格式

名称 类型 必填 示例 描述
phone string Y 15100000000 外部出行人手机号
name string Y 张三 外部出行人姓名
不大于 26 个字符
english_surname string N zhang 英文姓
英文姓 + 英文名不大于 26 个字符
默认为空字符
english_name string N san 英文名
英文姓 + 英文名不大于 26 个字符
默认为空字符
remark string N 因出差新增 备注信息
不大于 64 个字符
sex int N 1 0-空；1-男；2-女
默认为 0
out_traveler_id string N out_zhangsan_001 外部出行人唯一ID
不大于 32 个字符
birth_date string N 86691fccbd6d4f0 出生日期（YYYY-MM-DD），加密传输
card_list list<card> N 详见 card 格式 身份证件信息

data.card

名称 类型 必填 示例 备注
card_type int Y 1 证件类型：
1. 身份证
2. 护照
3. 港澳台居民居住证
4. 台胞证
5. 军官证
6. 回乡证
7. 外国人永久居留身份证
8.往来港澳通行证
9. 公务护照
10. 外交护照
11.其他
注意：身份证如果有值，则校验身份证长度必须合规
card_no string Y 1jua6691d6d4f04e 证件号码 加密传输
expire_date string N d6d4f04ed77b61e97 证件有效期 (YYYY-MM-DD) （需加密）加密传输
默认为空字符串

注意事项

请求示例

curl --location 'https://api.es.xiaojukeji.com/open-apis/v1/traveler/create' \
--header 'Content-Type: application/json' \
--data '{
    "access_token":"8d7475599691bd6d4f1504ed77b61e97",
    "client_id":"87fca1d9de6c20fccf2ccaa40_",
    "company_id":"1125915646167936",
    "param_json":"{\"phone\":\"11100009911\",\"name\":\"name\",\"english_surname\":\"\",\"english_name\":\"\",\"remark\":\"\",\"sex\":1,\"out_traveler_id\":\"11111\",\"birth_date\":\"\",\"card_list\":[{\"card_type\":1,\"card_no\":\"xxxxxxxxxxxx\",\"expire_date\":\"xxxxxxxxxxxxxx\"}]}",
    "sign":"5d3a57a8fd898a9eba1d82a8fc49620b",
    "timestamp":1689667125
}'

返回参数说明

字段 类型 说明
errno int 0表示成功，非0表示失败
errmsg string errno=0时为常量"SUCCESS"，errno!=0时为错误信息
data object 返回值对象 详见 data 格式

data

字段 类型 说明
id string 滴滴侧外部出行人 ID

错误码

code 描述
200002 out_traveler_id 重复

返回示例

{
    "errno":0,
    "errmsg":"SUCCESS",
    "data":{
        "id": "4441232560273757550"
    }
}

results matching ""

    No results matching ""