通讯录信息获取接口返回值说明
企业授权服务商应用套件后,服务商获取的通讯录权限以应用为单位,每个应用对应的可见范围以及额外权限都可以获取到。
服务商调用“获取企业授权信息”以及“获取永久授权码”两个接口与企业自行调用会存在一定差异,主要不同是auth_info节点。
返回结果示例
{
"auth_info": {
"is_new_auth":true,
"agent" : [
{
"agentid":1,
"name":"NAME",
"round_logo_url":"xxxxxx",
"square_logo_url":"yyyyyy",
"appid":1,
//"api_group":["get_location"]//废弃
"privilege":{
"level":1,//(1,2,3表示不同的权限等级)
"allow_party":[1,2,3],
"allow_user":["zhansan","lisi"],
"allow_tag":[1,2,3],
"extra_party":[4,5,6],
"extra_user":["wangwu"],
"extra_tag":[4,5,6]
}
},
{
"agentid":2,
"name":"NAME2",
"round_logo_url":"xxxxxx",
"square_logo_url":"yyyyyy",
"appid":5,
//"api_group":[]
}
],
//以下废弃
"department":[
{
"id":2,
"name":"PARTYNAME",
"parentid":1,
"writable":"true"
}
]
}
}
结果参数说明
参数
说明
is_new_auth
是否采用了新的授权,没有该字段或者该字段为false表示是旧授权,true表示是新授权
privilege
应用对应的权限
allow_party
应用可见范围(部门)
allow_tag
应用可见范围(标签)
allow_user
应用可见范围(成员)
extra_party
额外通讯录(部门)
extra_user
额外通讯录(成员)
extra_tag
额外通讯录(标签)
level
权限等级, 1: 标识信息只读, 2:信息只读, 3:信息读写