通讯录搜索-通讯录单个搜索

POST

/cgi-bin/service/contact/search

权限说明：

agentid为0则返回该服务商授权通讯录权限范围内的用户信息或者部门信息，否则返回指定agentid应用可见范围内的信息。
查询范围包含离职用户时，将查询一年内的所有离职用户。

注意：由于查询结果会过滤掉不在应用可见范围的成员与部门，所以每次返回的记录数可能小于limit。此时，如果is_last为false，则说明后续还有匹配的记录，服务商需要继续调用该接口进行查询。

请求参数

Query 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/service/contact/search?provider_access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "auth_corpid": "wwxxxxxx",
    "query_word": "zhangsan",
    "query_type": 1,
    "agentid": 1000046,
    "offset": 0,
    "limit": 50,
    "full_match_field": 1
}'

响应示例

{
    "errcode": 0,
    "errmsg": "ok",
    "query_result": {
        "user": {
            "userid": [
                "zhangshan",
                "lisi"
            ],
            "open_userid": [
                "wwxxxx",
                "wwxxxa"
            ]
        },
        "party": {
            "department_id": [
                1,
                2,
                3
            ]
        },
        "dismiss_user": {
            "userid": [
                "zhangshan",
                "lisi"
            ],
            "open_userid": [
                "wwxxxx",
                "wwxxxa"
            ]
        }
    },
    "is_last": false,
    "next_cursor": "NEXT_CURSOR"
}

修改于 2022-12-06 07:16:30

成员通知事件-新增成员事件

通讯录搜索-通讯录批量搜索