认证接口
概述
平台采用 JWT（JSON Web Token）进行身份验证，所有需要认证的接口都需要在请求头中携带有效的 Token。
生成 Token
接口信息
| 项目 | 说明 |
|---|---|
| 接口地址 | http://iot.datacom.vip:11111/Generate_Token |
| 请求方式 | POST |
Headers
| Key | Value |
|---|---|
Content-Type | application/json |
Body (raw JSON)
{
"Appkey": "your_appkey_here",
"Secret": "your_secret_here"
}
请求参数说明
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Appkey | string | 是 | 应用密钥（32 位） |
| Secret | string | 是 | 密钥（32 位） |
响应示例
{
"Code": 200,
"Type": "Success",
"Message": "Token Generated.",
"Token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"TokenEXP": 7200,
"RequestID": "a1b2c3d4e5f6"
}
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| Code | number | 响应码，200 表示成功 |
| Type | string | 响应类型 |
| Message | string | 响应消息 |
| Token | string | JWT Token 字符串 |
| TokenEXP | number | Token 过期时间（秒） |
| RequestID | string | 请求唯一标识 |
错误码
| 错误码 | 说明 |
|---|---|
| 10001 | 请求数据格式错误 |
| 10002 | 缺少必要参数 |
| 10003 | Appkey 或 Secret 长度错误（应为 32 位） |
| 20001 | Appkey 或 Secret 无效或已过期 |
Token 使用
在需要认证的接口中，将 Token 添加到请求头：
| Key | Value |
|---|---|
Authorization | Bearer <your_token> |
或
| Key | Value |
|---|---|
Authorization | <your_token> |
Token 有效期
- Token 有效期为 2 小时（7200 秒）
- 响应中会返回剩余的过期时间（TokenEXP）
- 建议在 Token 过期前重新生成