紧急联系人操作

功能:紧急联系人操作

注:第三方紧急联系人与滴滴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"
}

results matching ""

    No results matching ""