接口

https://{tokenServerUrl}/token/apply

使用场景

申请 Token 的接口应该由应用服务器发起，应用服务器验证 MQTT 客户端的权限范围后代替客户端向 MQTT 认证服务器申请 Token。

使用限制

单用户请求频率限制为 1000 次/秒。如有特殊需求，请提交工单申请。

请求参数

名称 类型 说明
actions String Token 的权限类型，有“R”（读），“W”（写），“R,W”（读和写） 三种类型。如果同时需要读和写的权限，“R”和“W”之间需要用逗号隔开。
resources String 资源名称，即 MQTT Topic，多个 Topic 以逗号（,）分隔，每个 Token 最多运行操作 100 个资源，当有多个 Topic 时，需要按照字典序排序。

申请 Token 时注册的资源参数支持 MQTT 通配符语法，包含加号单级通配符（+）和井号多级通配符（#）。

例如，如果申请 Token 时指定 resources 为 “Topic1/+”，则客户端可以操作 “Topic1/xxx” 的任意 Topic；如果申请 Token 时指定 resources 为 “Topic1/#”，则客户端可以操作 “Topic1/xxx/xxx/xxx” 的任意多级 Topic。

accessKey String 当前请求使用的账号的 AccessKeyId。
expireTime Long Token 失效的毫秒时间戳，允许设置的失效最小间隔是 60 秒，最长为 30 天。如果输入的取值超过 30 天，申请接口不会报错，但实际生效时间为 30 天。
proxyType String Token 类型，填 MQTT，根据实际产品选择。
serviceName String 填 mq，其他参数无效 。
instanceId String MQTT 实例 ID，一定要和客户端实际使用的实例 ID 匹配。
signature String 签名字符串，本请求需要计算签名的字段是 actions、resources、expireTime、serviceName、instanceId。
注意 请勿对返回的 Token 内容做任何长度、格式或规则的假设。