接口介绍
鉴权接口用于验证 API 密钥的有效性。共1个接口：
接口 | 方法 | 功能 |
/v3/auth/verify | POST | 验证鉴权信息 |
验证鉴权信息
验证当前请求携带的 API Key 和实例 ID 是否有效。
POST /v3/auth/verify
请求参数
无额外请求参数，鉴权信息通过 Header 传递。
请求示例
curl -i -X POST \\-H 'Content-Type: application/json' \\-H 'Authorization: Bearer *********************************' \\-H "x-tdai-service-id: tdai-mem-xxxxxxxx" \\https://memory.tdai.tencentyun.com/v3/auth/verify \\-d '{}'
响应示例
{"code":0,"message":"ok","request_id":"req-7fd3b2dd","data":{"valid":true,"service_id":"tdai-mem-xxxxxxxx","user_id":"user-123"}}
响应 data
字段 | 类型 | 说明 |
valid | bool | 鉴权信息是否有效 |
service_id | string | 当前实例 ID |
user_id | string | 当前用户 ID（如有） |
错误码
HTTP 状态码 | 错误信息 | 说明 |
400 | request: Invalid input | 请求参数不合法。 |
401 | Missing or invalid Authorization header | Bearer API Key 缺失或格式不正确。 |
| Missing x-tdai-service-id header | 请求头中未携带 x-tdai-service-id。 |
401 | AUTH_FAILED | API Key 无效或已过期。 |
500 | Internal error | 服务内部错误，可有限重试。 |