第三方应用开发 服务端API 通讯录管理 通讯录userid排序
通讯录userid排序
最后更新:2022/09/05
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
通讯录userid排序
最后更新:2022/09/05

请求方式:POST(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/service/contact/sort?provider_access_token=ACCESS_TOKEN

请求包体:

{
	"auth_corpid":"wwxxxxxx",
	"useridlist":["zhangshan","lisi"],
	"sort_options":[
		{
			"sort_field": 0,
			"sort_type": 1
		},
		{
			"sort_field": 1,
			"sort_type": 0
		}
	]
}

参数说明:

参数必须说明
provider_access_token应用提供商的provider_access_token,获取方法参见服务商的凭证
auth_corpid查询的企业corpid
useridlist要排序的userid列表,最多支持1000个
sort_options排序选项列表。如果指定多个,将根据优先级排序。如示例参数,先根据姓名拼音降序排列,如果姓名拼音相同,再根据别名升序排列
sort_options.sort_field排序属性。0: 根据姓名拼音排序,1: 根据别名排序
sort_options.sort_type排序方式。0: 升序排列,1: 降序排列

权限说明:

useridlist中的userid必须为该服务商授权通讯录权限范围内的用户

返回结果:

{
   "errcode": 0,
   "errmsg": "ok",
   "useridlist":["lisi","zhangshan"]
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
useridlist排序后的userid列表
上一篇
异步任务回调通知
下一篇
第三方通讯录编辑授权