设置源 Channel发送限制

接口边界

调用方：仅限受信业务后端
作用域：实际源 Channel 发送限制；个人 ID 必须规范编码，CMD 派生键不可用；不影响登录、接收或协议 ACK。
原子性：策略与独立 uint64 版本在一次 Slot 应用内原子变更；相同值不递增版本。
成功判定：200 返回已应用的策略；版本以十进制字符串返回，终态解散不可逆。
恢复：超时或 503 可能已经提交；先 GET 核对当前策略。409 后重读并重新作出变更决定，不盲目重试旧 expected_version。

POST/channel/send_ban

在 Slot 应用内原子变更发送策略，支持字符串 CAS；相同值保留版本。

请求主体

application/json

严格、有界的策略变更。

TypeScript 定义

在 TypeScript 中使用 request body 类型。

严格单个 JSON 对象，最多 4096 字节；拒绝未知字段和尾随 JSON，数值字段须符合 Go 整数语法。

channel_id*string

实际源 Channel ID，最多 1024 个 UTF-8 字节；个人 Channel ID 必须是规范编码，拒绝 CMD 派生 ID。

匹配^\S(?:[\s\S]*\S)?$

长度1 <= length <= 1024

channel_type*integer

源 Channel 类型；1 为规范个人 Channel，2 为群组。

范围1 <= value <= 255

uid?|

Channel 策略须省略此字段，或传空字符串、null。

值于

""
null

send_ban*integer

必填整数标志：1 限制应用 SEND，0 解除限制；登录、接收和协议 ACK 仍允许。

值于

expected_version?|

可选的应用时 CAS 版本；省略或 null 表示无条件写入，拒绝溢出、前导零和符号。

匹配

^(?:0|[1-9][0-9]{0,18}|1[0-7][0-9]{18}|18[0-3][0-9]{17}|184[0-3][0-9]{16}|1844[0-5][0-9]{15}|18446[0-6][0-9]{14}|184467[0-3][0-9]{13}|1844674[0-3][0-9]{12}|184467440[0-6][0-9]{10}|1844674407[0-2][0-9]{9}|18446744073[0-6][0-9]{8}|1844674407370[0-8][0-9]{6}|18446744073709[0-4][0-9]{5}|184467440737095[0-4][0-9]{4}|18446744073709550[0-9]{3}|18446744073709551[0-5][0-9]{2}|1844674407370955160[0-9]{1}|1844674407370955161[0-4]|18446744073709551615)$

响应主体

`application/json`

{  "status": 200,  "data": {    "channel_id": "string",    "channel_type": 1,    "send_ban": 0,    "send_ban_version": "string"  }}

设置源 Channel发送限制

请求主体

响应主体

200application/json

400application/json

404application/json

409application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`