回拨拉取主叫显号号码集合

最近更新时间:2019-05-24 16:26:48

1. 接口描述

功能: 回拨拉取主叫显号号码集合
接口地址: https://HOST/201511v3/getCallerDisplayList?id=xxx
请求方式:POST

注意:

上述接口地址的 ID 值测试时由腾讯统一分配。
所有参数类型都是字符串类型(string)。

2. 参数说明

变量名 类型 说明
appId String xxx
codeList 可选 主叫显号号码集合,codeList[0...*] 结构体数组,如果业务是主被叫互显,该字段为空

codeList结构体:

变量名 类型 说明
nation String 国家码,统一以 00 开头
phone String 号码(固话区号前加 0,如075586013388)

3. 返回结果

参考值 描述
0 成功
-1 版本不支持
-2 参数异常
-401 appId 非法
-402 URL 不匹配
-403 IP 不在白名单
-423 服务器屏蔽此调用(调用方被入侵或者异常操作)
-501 平台处理请求异常(业务做容灾处理)

4. 示例

成功:

{
    "errorCode": "0", 
    "appId": "xxx", 
    "codeList": [
        {
            "nation": "0086", 
            "phone": "008613192669272"
        }
    ]
}

失败:

{
    "errorCode": "-1", 
    "msg": "version not support"
}