TTAPI 网关是所有接口请求的统一入口，负责请求路由、身份验证、流量控制等核心能力。所有接口调用均需通过网关并完成鉴权，未通过鉴权的请求将直接返回 401 错误。
1. 通用 API 域名
- 主域：
https://api.ttapi.io
备注：基于 Cloudflare 部署，存在同步超时风险；
- 加速域：
https://api.ttapi.org
备注：请求耗时较长的接口推荐使用此域名，可降低延迟。
2. MJ 托管 API 专属域名
- 主域：
https://hold.ttapi.io
备注：基于 Cloudflare 部署，存在同步超时风险；
- 加速域：
https://hold.ttapi.org
备注：可有效降低访问延迟，提升请求稳定性。
一、鉴权方式
所有接口均通过请求头携带 TT-API-KEY 字段完成鉴权，该字段可在 开发者控制台 获取。
鉴权规则
- 字段位置：HTTP Request Header
- 字段名称：
TT-API-KEY（大小写敏感）
- 字段值格式：
{TT-API-KEY}（控制台生成的完整密钥）
二、网关请求规范
| 项 | 要求 |
|---|
| 请求协议 | HTTPS（强制，禁止 HTTP） |
| 请求方法 | 按接口定义使用（POST/GET/PUT/DELETE） |
| 字符编码 | UTF-8 |
| 内容类型 | JSON（application/json） |
三、鉴权错误码
| 错误码 | 解决方案 |
|---|
| 401 | 检查请求头是否携带 TT-API-KEY 字段以及 TT-API-KEY 是否正确 |
错误响应格式
所有鉴权错误均返回统一格式：
{
"status": "FAILED",
"message": "Wrong TT-API-KEY or email is not activated."
}
Last modified on March 12, 2026
