中望帐号

刷新企业用户部门

测试中

正式环境

https://accounts.zwsoft.cn

POST

/api/v1.0/trusted/corps/departments/refresh

公开

最后修改时间：2025-04-29 01:26:53

需要scope：ZMS.Users.Write

全企业刷新效率较低，建议利用userGuids字段限制刷新用户范围

provider目前只对WorkWeChat生效

企业必须在企微后台授权【中望账号】代开发应用

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

corpId

string

企业guid

必需

provider

string

第三方提供商

必需

WorkWeChat

userGuids

array[string]

用户GUID列表

可选

示例

{
    "corpId": "string",
    "provider": "string",
    "userGuids": [
        "string"
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://accounts.zwsoft.cn/api/v1.0/trusted/corps/departments/refresh' \
--header 'Content-Type: application/json' \
--data-raw '{
    "corpId": "string",
    "provider": "string",
    "userGuids": [
        "string"
    ]
}'

返回响应

🟢200成功

application/json

Body

status

integer

返回码

必需

详情请查看全局返回码

message

string

错误详细信息

必需

无错误时，返回：success

error

string | null

错误代号

必需

详情请查看全局返回码

data

array [object {1}]

必需

userGuids

array[string]

刷新的用户GUID

必需

示例

{
    "status": 0,
    "message": "string",
    "error": "string",
    "data": [
        {
            "userGuids": [
                "string"
            ]
        }
    ]
}

修改于 2025-04-29 01:26:53

批量修改用户详细信息

推送服务消息