userid与openid互换-userid转openid

POST

http://127.0.0.1/cgi-bin/user/convert_to_openid

智慧硬件开发/通讯录管理/成员管理

最后修改时间：2022-08-30 03:03:36

责任人：未设置

该接口使用场景为企业支付，在使用企业红包和向员工付款时，需要自行将企业微信的userid转成openid。

注：需要成员使用微信登录企业微信或者关注微工作台（原企业号）才能转成openid;
如果是外部联系人，请使用外部联系人openid转换转换openid

权限说明：成员必须处于应用的可见范围内

文档ID: 11279
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/90202
https://open.work.weixin.qq.com/api/doc/90001/90143/90338
https://open.work.weixin.qq.com/api/doc/90002/90151/90821

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

userid

string

企业内的成员id

必需

示例

{
  "userid": "zhangsan"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'http://127.0.0.1/cgi-bin/user/convert_to_openid?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userid": "zhangsan"
}'

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

openid

string

可选

企业微信成员userid对应的openid

errmsg

string

可选

对返回码的文本描述内容

示例

{
  "errcode": 0,
  "openid": "string",
  "errmsg": "string"
}

获取部门成员详情

userid与openid互换-openid转userid