/communication/push-tokens/{push_token_id}
更新指定推送令牌的激活状态(is_active)。停用后该令牌不再接收推送,重新激活后恢复。参考:ePrivacy Directive 2002/58/EC、CAN-SPAM Act。
请求参数
| 名称 | 位置 | 类型 | 必填 | 默认值 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|---|---|
push_token_id |
path |
string |
是 | 推送令牌ID |
请求体
Schema: service-communication/internal/handler/dto.UpdatePushTokenRequest
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
user_id |
string |
是 | usr_abc123 |
||
is_active |
boolean |
否 | True |
响应
| 状态 | 描述 | Schema |
|---|---|---|
| 200 | 更新成功 | service-communication/internal/handler/dto.OKResponse |
| 400 | 请求参数错误 | dto.SimpleResponse |
| 401 | 未认证或令牌无效 | dto.SimpleResponse |
| 403 | 无权访问该资源 | dto.SimpleResponse |
| 404 | 令牌不存在 | dto.SimpleResponse |
| 500 | 服务内部错误 | dto.SimpleResponse |
引用的 Schema
dto.SimpleResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |
service-communication/internal/handler/dto.OKResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | 0 |
||
message |
string |
否 | success |