- Overview of OpenAPI
- SlackOpenAPI
- ShopifyOpenAPI
- GithubAPI
- DiscordOpenAPI
- 历史文档(不推荐)
- 开发钉钉应用
- 服务端API
- 新版服务端API(DingTalk OpenAPI)
- 生态伙伴API
邀请成员
POST
http://127.0.0.1/cgi-bin/batch/invite
智慧硬件开发/通讯录管理/成员管理
最后修改时间:2022-08-30 03:03:36
责任人:未设置
须拥有指定成员、部门或标签的查看权限。
user, party, tag三者不能同时为空;
如果部分接收人无权限或不存在,邀请仍然执行,但会返回无效的部分(即invaliduser或invalidparty或invalidtag);
同一用户只须邀请一次,被邀请的用户如果未安装企业微信,在3天内每天会收到一次通知,最多持续3天。
因为邀请频率是异步检查的,所以调用接口返回成功,并不代表接收者一定能收到邀请消息(可能受上述频率限制无法接收)。
原文档地址:
https://open.work.weixin.qq.com/api/doc/90000/90135/90975
https://open.work.weixin.qq.com/api/doc/90001/90143/91127
https://open.work.weixin.qq.com/api/doc/90002/90151/91159
请求参数
Query 参数
access_token
string
调用接口凭证
示例值:
{{accesstoken}}
Body 参数application/json
access_token
array[string]
调用接口凭证
tag
array[string]
可选
user
array[string]
可选
party
array[string]
可选
示例
{"user":["UserID1","UserID2","UserID3"],"party":[PartyID1,PartyID2],"tag":[TagID1,TagID2]}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'http://127.0.0.1/cgi-bin/batch/invite?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{"user":["UserID1","UserID2","UserID3"],"party":[PartyID1,PartyID2],"tag":[TagID1,TagID2]}'
返回响应
🟢200成功
application/json
Body
errcode
integer
必需
errmsg
string
必需
invaliduser
array[string]
非法成员列表
invalidparty
array[string]
非法部门列表
invalidtag
array[string]
非法标签列表
示例
{
"errcode": 0,
"errmsg": "string",
"invaliduser": [
"string"
],
"invalidparty": [
"string"
],
"invalidtag": [
"string"
]
}

修改于 2022-08-30 03:03:36