调用GetUserByExtension根据坐席分机号获取用户信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String GetUserByExtension

系统规定参数。取值:GetUserByExtension。

InstanceId String 9cfad875-6260-4a53-ab6e-b13e3fb31f7d

呼叫中心实例ID。

Extension String 80370351

坐席分机号。

返回数据

名称 类型 示例值 描述
Code String OK

响应码。

HttpStatusCode Integer 200

HTTP状态码。

Message String

响应信息。

RequestId String 9FBA26B0-462B-4D77-B78F-AF35560DBC71

请求ID。

Success Boolean true

是否成功。

User Struct

用户信息。

Detail Struct

用户详细信息。

Department String IT

用户的部门。

DisplayName String test

用户的姓名。

Email String test@alibaba-inc.com

用户的电子邮件地址。

Extension String 80370351

坐席分机号。

LoginName String test123

用户登陆名/用户名。

Phone String 13601763214

用户的电话号码。

InstanceId String 9cfad875-6260-4a53-ab6e-b13e3fb31f7d

用户所归属的呼叫中心实例ID。

RamId String 202254621208793807

用户所对应的RAM账户ID。

Roles Array of Role

用户的角色列表。

InstanceId String 9cfad875-6260-4a53-ab6e-b13e3fb31f7d

用户所归属的呼叫中心实例ID。

RoleDescription String 管理员

角色描述。

RoleId String 59a3d864-2f98-4f5e-84ec-c1ea13af93f3

角色ID,系统自动生成的唯一标示符。

RoleName String ADMIN

角色名称。

SkillLevels Array of SkillLevel

用户所归属的技能组及相应等级,一个用户可以不属于任何技能组。

Level Integer 4

技能级别。

Skill Struct

技能组。

InstanceId String 9cfad875-6260-4a53-ab6e-b13e3fb31f7d

技能组所归属的呼叫中心实例。

SkillGroupDescription String 描述

技能组简单描述。

SkillGroupId String a053e6d5-16ee-4283-9c81-631b78ae08a2

技能组唯一ID,系统自动生成的唯一标示符。

SkillGroupName String 默认技能组

技能组名字,需要在所归属的呼叫中心实例中唯一。

SkillLevelId String 181792

技能级别唯一ID,系统自动生成的唯一标示符。

UserId String 6f3e7751-fa61-453f-8057-a2fe9741a387

用户ID,系统自动生成的唯一标示符。

示例

请求示例

http(s)://[Endpoint]/?Action=GetUserByExtension
&InstanceId=9cfad875-6260-4a53-ab6e-b13e3fb31f7d
&Extension=80370351
&<公共请求参数>

正常返回示例

XML 格式

<User>
    <SkillLevels>
        <Level>4</Level>
        <SkillLevelId>181792</SkillLevelId>
    </SkillLevels>
    <SkillLevels>
        <Skill>
            <SkillGroupName>默认技能组</SkillGroupName>
            <InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
            <SkillGroupId>a053e6d5-16ee-4283-9c81-631b78ae08a2</SkillGroupId>
            <SkillGroupDescription>描述</SkillGroupDescription>
        </Skill>
    </SkillLevels>
    <InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
    <UserId>6f3e7751-fa61-453f-8057-a2fe9741a387</UserId>
    <RamId>202254621208793807</RamId>
    <Roles>
        <RoleDescription>管理员</RoleDescription>
        <RoleName>ADMIN</RoleName>
        <InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
        <RoleId>59a3d864-2f98-4f5e-84ec-c1ea13af93f3</RoleId>
    </Roles>
    <Detail>
        <Extension>80370351</Extension>
        <LoginName>test123</LoginName>
        <Department>IT</Department>
        <Email>test@alibaba-inc.com</Email>
        <Phone>13601763214</Phone>
        <DisplayName>test</DisplayName>
    </Detail>
</User>
<Message>无</Message>
<RequestId>9FBA26B0-462B-4D77-B78F-AF35560DBC71</RequestId>
<HttpStatusCode>200</HttpStatusCode>
<Code>OK</Code>
<Success>true</Success>

JSON 格式

{
	"User": {
		"SkillLevels": [{
			"Level": "4",
			"SkillLevelId": "181792"
		}, {
			"Skill": {
				"SkillGroupName": "默认技能组",
				"InstanceId": "9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
				"SkillGroupId": "a053e6d5-16ee-4283-9c81-631b78ae08a2",
				"SkillGroupDescription": "描述"
			}
		}],
		"InstanceId": "9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
		"UserId": "6f3e7751-fa61-453f-8057-a2fe9741a387",
		"RamId": "202254621208793807",
		"Roles": [{
			"RoleDescription": "管理员",
			"RoleName": "ADMIN",
			"InstanceId": "9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
			"RoleId": "59a3d864-2f98-4f5e-84ec-c1ea13af93f3"
		}],
		"Detail": {
			"Extension": "80370351",
			"LoginName": "test123",
			"Department": "IT",
			"Email": "test@alibaba-inc.com",
			"Phone": "13601763214",
			"DisplayName": "test"
		}
	},
	"Message": "无",
	"RequestId": "9FBA26B0-462B-4D77-B78F-AF35560DBC71",
	"HttpStatusCode": "200",
	"Code": "OK",
	"Success": "true"
}

错误码

访问错误中心查看更多错误码。