紧急联系人操作
功能:紧急联系人操作
注:第三方紧急联系人与滴滴app内紧急联系人相互隔离,支持增删改
资源URL:
POST: v1/safe/contacter
请求参数
参数名称 | 类型 | 说明 |
---|---|---|
client_uid | string | 乘客在第三方的uid,不变且唯一 |
phone | string | 乘车人手机号 |
contacters | json | 紧急联系人信息列表,二维数组,覆盖原有紧急联系人信息(需至少保留一个) |
contacters字段结构如下:
参数名 | 类型 | 含义 | 是否必须 | 示例 |
---|---|---|---|---|
name | string | 昵称 | 是 | |
countryCode | string | 国家码 | 否,默认为“86” | |
phone | string | 手机号 | 是 | |
isAuto | int | 是否开启自动行程分享,0:不开启,1:开启 | 否,默认0 | 0/1 |
queryAuth | int | 是否开启紧急联系人查询授权,0:不开启,1:开启 | 否,默认0 | 0/1 |
distance | int | 设置行程分享起终点距离,大于该值即分享,单位米 | 否,默认不设置 | 3000 |
shareStartTime | string | 单个联系人的行程分享开始时间,00:00-23:00 | 否,默认不设置(必须整点) | "08:00" |
shareEndTime | string | 单个联系人的行程分享结束时间,00:00-24:00 | 否,默认不设置(必须整点) | "19:00" |
请求示例:
curl -X POST 'http://10.179.181.175:8000/gulfstream/gs-openapi/v1/safe/contacter?XDEBUG_SESSION_START=16822'
-H 'authorization: Bearer test|didi81673C87BE13734F820ADA13E10ACE59183B3BB4F077DCE1FB91D8271181FCC8B319EB33214E33368AF88762DEACD2C1B77B8191A3AD0F7E74C41ED29D1FF143'
-H 'content-type: application/json'
-d '{"client_uid":"12sss34445","phone":"11100011296","contacters":[
{
"name": "张三",
"countryCode": "86",
"phone": "11100011291",
"isAuto": false,
"queryAuth": 0,
"distance": 100,
"shareStartTime": "06:00",
"shareEndTime": "22:00"
},
{
"name": "李四",
"countryCode": "86",
"phone": "11100011292",
"isAuto": false,
"queryAuth": 0,
"distance": 100,
"shareStartTime": "06:00",
"shareEndTime": "22:00"
}
]}'
返回参数说明:
参数名 | 类型 | 说明 |
---|---|---|
error | string | 0成功,其他值失败 |
error_detail | string | 错误描述 |
返回成功示例:
成功:http status 200
{
"error":"code(0)",
"error_detail":"success"
}
返回失败示例:
失败:http status 非200
{
"error":"code(40010)",
"error_detail":"参数错误:client_uid"
}