访问配置文件
您可以通过使用标识符查询或指定与概要文件关联的人员的Zendesk用户id来获取概要文件。亚博标识符查询返回一个概要文件。Ze亚博ndesk用户id返回与该用户关联的所有配置文件。
还可以通过配置文件id获取配置文件。但是,由于获得概要文件id的唯一方法是使用上述两种方法之一请求概要文件,因此根据概要文件id进行额外请求将返回重复的信息。如果您有配置文件id的用例,请参见通过配置文件id获取配置文件在参考文档中。
有关创建概要文件的信息,请参见创建概要文件.
本文包括curl和Python示例。Python示例使用Python 3.6或更高版本请求图书馆。
通过标识符查询访问概要文件
您可以通过使用标识符查询来获取特定的配置文件:
GET / api / v2 / user_profiles吗?标识符= {identifier_query}
标识符查询选择一个特定的概要文件。例子:
coolbikes:骑手:电子邮件:(电子邮件保护)
查询中的前两项,coolbikes
而且骑手
,指定目标配置文件源而且类型属性。最后两项,电子邮件
而且(电子邮件保护)
,在配置文件中为人员指定标识符。
这四项都是必需的。例如,你不能只指定一个源和一个类型来获取Coolbikes上的所有“骑手”配置文件。
有关更多信息,请参见使用配置文件中的标识符查询.
例子
数据
标识符查询:
“coolbikes:骑手:电子邮件:(电子邮件保护)"
curl请求
Python的请求
响应
状态200好吧
{
“配置文件”:{
“id”:“01 e06hxmj8rj6c0mr142d6fbsa”,
“user_id”:“81123613”,
“源”:“coolbikes”,
“类型”:“骑士”,
“名称”:“简”,
“属性”:{
“favorite_color”:“红色”,
“saddle_height”:“85厘米”
},
“created_at”:“2020 - 02 - 03 - t22:14:48z”,
“updated_at”:“2020 - 02年- 20 - t01:20:28z”,
“标识符”:[
{
“类型”:“电子邮件”,
“价值”:"(电子邮件保护)"
}
]
}
}
通过Zendesk用户id访问配置文件亚博
因为每个配置文件都与一个Zendesk用户相关联,所以可以使用Zendesk用户id亚博来获取与该用户相关联的所有配置文件。
GET / api / v2 /用户/ {user_id} /配置文件
该请求返回与该用户关联的所有概要文件的列表。
看到用户在Zendes亚博k API文档中。
例子
数据
亚博Zendesk用户id:
“85211553”
curl请求
旋度https://coolbikes.亚博.com/api/v2/用户/85211553/profiles \
-v-u(电子邮件保护).com:t1retube5
Python的请求
进口请求
user_id=“85211553”
url=f“https://coolbikes.亚博zendesk.com/api/v2/users/ {user_id} /配置文件”
凭证='(电子邮件保护)',“t1retube5”
响应=请求.得到(url,身份验证=凭证)
如果响应.status_code! =200:
打印(f”{响应。status_code}:{响应.text}')
其他的:
打印(响应.json())
响应
状态200好吧
{
“配置文件”:[
{
“id”:“01 e06hxmj8rj6c0mr142d6fbsa”,
“user_id”:“81123613”,
“源”:“coolbikes”,
“类型”:“骑士”,
“名称”:“简”,
“属性”:{
“favorite_color”:“红色”,
“saddle_height”:“85厘米”
},
“created_at”:“2020 - 02 - 03 - t22:14:48z”,
“updated_at”:“2020 - 02年- 20 - t01:20:28z”,
“标识符”:[
{
“类型”:“电子邮件”,
“价值”:"(电子邮件保护)"
}
]
},
{
“id”:“01 e063f8d3br6fr7104khyne41”,
“user_id”:“81123613”,
“源”:“极致”,
“类型”:“客户”,
“名称”:“sunshine_user”,
“属性”:{
“认证”:“球员”,
“comm_pref”:“短信”
},
“created_at”:“2020 - 02 - 03 - t18:02:17z”,
“updated_at”:“2020 - 03 - 06 - t22:03:32z”,
“标识符”:[
{
“类型”:“电子邮件”,
“价值”:"(电子邮件保护)"
}
]
}
]
}