接口描述
描述:该接口用于在校验绑定手机号合法性时,获取所需的依赖 token(有效期5分钟,过期失效)。
请求方式:POST
鉴权方式:AK/SK 鉴权
依赖权限点:自建应用具备管理企业用户权限。
接口请求域名:
https://api.meeting.qq.com/v1/users/phone/get-tokene
输入参数
请求体
参数名称 | 必选 | 参数类型 | 示例值 | 参数描述 |
area | 是 | String | 86 | 电话区号。(例如:中国内地默认86) 当前仅支持中国内地地区使用。 |
phone | 是 | String | 138*****000 | 电话号码或固定电话总机号。 |
operator_id | 是 | String | meeting*****196 | 需绑定手机号的用户 id。 operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。 绑定手机号的用户 id 必须和目标绑定的用户 id 一致。 |
operator_id_type | 是 | Integer | 1 | 绑定手机号用户 id 的类型: 1:userid |
code | 是 | String | 653445 | 验证码为6位,10分钟内有效。 |
输出参数
参数名称 | 参数类型 | 示例值 | 参数描述 |
token | String | 5w8****ur781 | 验证码的值,绑定新手机号时,需在调用校验验证码接口时传入验证码,其有效期为5分钟。 |
错误码列表
状态码 | 错误码 | 错误描述 |
400 | 500191 | 验证码中心通用错误(手机号发送超限、校验超限、验证码不正确)。 |
400 | 550000 | 请求超时,请稍后再试。 |
400 | 190004 | 请求参数错误。 |
示例
输入示例
POST https://api.meeting.qq.com/v1/users/phone/get-tokene?area=86&phone=13800000000&opeartor_id=KM4Ss48789745w1JiK&operator_id_type=1&cede=336754
输出示例
{"token":"5w8gthtur781"}