文档首页/云客服/API参考/系统配置类接口参考（API Fabric）/移动座席和双呼功能集成/获取呼叫目的设备信息 (getCalledInfo)
更新时间：2025-11-13 GMT+08:00
查看PDF
分享

获取呼叫目的设备信息 (getCalledInfo)

场景描述

获取呼叫数据。

接口方法

POST

接口URI

https://域名/apiaccess/CC-Management/v1/mobileAgent/getCalledInfo，例如域名是service.besclouds.com

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

X-APP-Key

string

False

appKey字段，用户标识

2

Authorization

string

True

鉴权字段，内容格式为：Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格）

表2 请求体参数

序号

名称

参数类型

是否必选

说明

1

called

string

True

被叫号码

长度限制:string(32)

1

caller

string

True

主叫号码

长度限制:string(32)

响应说明

  • 响应状态码: 200
表3 响应体参数

序号

名称

参数类型

是否必选

说明

1.1

retCode

string

True

返回码。0表示成功，其他为失败。

4：获取不到被叫标示

5：被叫未配置标示

1.2

retMsg

string

True

失败原因的描述

1.3

result

object

False

返回结果

1.3.1

devType

number

False

设备类型:

0：技能队列；

1：号码

长度限制：number (4)

1.3.2

called

string

False

被叫号码

长度限制:string(32)

1.3.3

skillId

number

False

技能队列

长度限制：number (16)

1.3.4

skillName

string

False

技能队列名称

长度限制：string(100)

  • 响应状态码: 400

    错误的请求：请检查请求路径及参数。

  • 响应状态码: 401

    未授权：1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。

  • 响应状态码: 404

    请求的内容未找到：请检查请求的路径。

  • 响应状态码: 500

    业务失败：请依次确认您请求中各参数的取值。

错误码

无。

报文样例

  • 场景描述：样例报文

    请求头：

    x-app-key:9******************************3  
Authorization:Bearer 9******************************7  
Content-Type:application/json

    请求参数:

    {
	"caller": "8888888",
	"called": "6666614"
}

    响应参数:

    {
	"retMsg": "Called is not configured",
	"retCode": "5"
}