批量设置用户席位

POST

/sdk/v2/api/license/users/set-status

请勿频繁激活用户

请勿频繁修改正常用户的激活状态，每个用户当月内只能被激活（未激活->已激活）一次。

提示

由于“App 管理”相关的接口的特殊性，为了安全考虑，需要在生成签名时附加上 "scope": "license" 字段。

用户状态特殊说明

设置为 -1 未启用 并不能阻止用户继续使用石墨 SDK，比如用户打开的石墨 SDK 页面并没有关闭，signature 和 token 仍有效，即使设置为 -1 未启用，只要用户未关闭的页面发起了请求（例如编辑、评论），状态也会被自动设置为 1 激活。

请求参数

Header 参数

Body 参数application/json

示例

{
    "userIds": [
        "1",
        "2"
    ],
    "status": 1
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/sdk/v2/api/license/users/set-status' \
--header 'X-Shimo-Signature: {{signature}}' \
--header 'X-Shimo-Token: {{token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userIds": [
        "1",
        "2"
    ],
    "status": 1
}'

返回响应

🟢204成功

text/plain

修改于 2026-04-02 02:00:19

取消用户席位

访问协同文档