企业和第三方可通过此接口,获取所有离职成员的客户列表,并可进一步调用分配离职成员的客户接口将这些客户重新分配给其他企业成员。
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_unassigned_list?access_token=ACCESS_TOKEN
请求示例:
{
"cursor":"",
"page_size":100
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
page_size | 否 | 每次返回的最大记录数,默认为1000,最大值为1000 |
cursor | 否 | 分页查询游标,字符串类型,适用于数据量较大的情况,如果使用该参数则无需填写page_id,该参数由上一次调用返回 |
权限说明:
返回结果:
{
"errcode":0,
"errmsg":"ok",
"info":[
{
"handover_userid":"zhangsan",
"external_userid":"woAJ2GCAAAd4uL12hdfsdasassdDmAAAAA",
"dimission_time":1550838571
},
{
"handover_userid":"lisi",
"external_userid":"wmAJ2GCAAAzLTI123ghsdfoGZNqqAAAA",
"dimission_time":1550661468
}
],
"is_last":false,
"next_cursor":"aSfwejksvhToiMMfFeIGZZ"
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
info.handover_userid | 离职成员的userid |
info.external_userid | 外部联系人userid |
info.dimission_time | 成员离职时间 |
is_last | 是否是最后一条记录 |
next_cursor | 分页查询游标,已经查完则返回空(""),使用page_id 作为查询参数时不返回 |