手机号转外部联系人ID

POST

/cgi-bin/externalcontact/batch_to_external_userid

权限说明：
学校需要使用“家校沟通”secret所获取的accesstoken来调用（accesstoken如何获取？）；
第三方应用需拥有「家校沟通」使用权限。

文档ID: 19932
原文档地址：
https://open.work.weixin.qq.com/api/doc/90001/90143/92506

请求参数

Query 参数

Body 参数application/json

示例

{"mobiles":["10000000000","10000000001"]}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/cgi-bin/externalcontact/batch_to_external_userid?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{"mobiles":["10000000000","10000000001"]}'

返回响应

🟢200成功

application/json

Body

示例

{
    "errcode": 0,
    "errmsg": "ok",
    "success_list": [
        {
            "mobile": "18900000000",
            "external_userid": "aaabbbcccc"
        }
    ],
    "fail_list": [
        {
            "errcode": 60136,
            "errmsg": "record not found",
            "mobile": "10000000001"
        }
    ]
}

修改于 2025-03-26 09:11:31

外部联系人openid转换

管理「老师可查看班级」模式-设置「老师可查看班级」的模式