# 自述文档 - 中文

> This page is also available in English: [README - English](https://docs.tikhub.io/4592766m0)

### 【常用链接】

- 🏡 **官网首页**: [https://www.tikhub.io](https://www.tikhub.io)
- 👤 **用户控制台**: https://user.tikhub.io/
- 🐙 **GitHub 组织**: [https://github.com/TikHub](https://github.com/TikHub)
- 🛠 **Python SDK**: [https://github.com/TikHub/TikHub-API-Python-SDK](https://github.com/TikHub/TikHub-API-Python-SDK)
- 📥 **多功能下载器**: [https://github.com/TikHub/TikHub-Multi-Functional-Downloader](https://github.com/TikHub/TikHub-Multi-Functional-Downloader)
- 🖥️ **API 示例**: [https://github.com/TikHub/TikHub-API-Demo](https://github.com/TikHub/TikHub-API-Demo)
- 📚 **官方文档**: [https://docs.tikhub.io](https://docs.tikhub.io)
- 💬 **Discord 社区（社区交流与讨论）**: [https://discord.gg/Pu2uKkFu6u](https://discord.gg/Pu2uKkFu6u)
- 🎫 **联系与支持**: https://user.tikhub.io/dashboard/support/open-tickets — 请登录用户控制台提交工单
- ✨ **X.com（推特）**: [https://x.com/TikHubio](https://x.com/TikHubio)

---

## 📢 TikHub 域名与连接公告

尊敬的 TikHub 用户：

关于 API 访问，请注意以下事项：

* **✅ 主域名：** 请使用 `https://api.tikhub.io` 发起所有请求。
  🚫 请勿使用 `api.tikhub.dev`，否则可能导致响应速度变慢、性能下降。

* **⏱️ 请求耗时过长（超过 30 秒）？**
  请在您本地配置代理，以提升连接稳定性。

* **⚙️ 说明：** 无论使用哪个域名，所有请求路径与参数均保持一致——除更换基础域名外，无需修改任何代码。

---

#### HTTP 状态码说明

* **400 Bad Request（请求错误）**
  * 请求格式不正确或参数无效，有时也可能因服务器内部错误导致。
* **401 Unauthorized（未授权）**
  * API 令牌无效。
  * API 令牌缺失。
  * 无法验证 API 令牌。
  * API 令牌状态无效或未激活。
  * API 令牌已过期。
  * 用户不存在。
* **403 Forbidden（禁止访问）**
  * 缺少该接口所需权限。
  * 账户已被禁用。
  * 邮箱未验证。
  * API 令牌缺少所需权限。
* **404 Not Found（未找到）**
  * 数据库中未找到该接口对应的数据。
* **402 Payment Required（需要付费）**
  * 余额不足，该接口需要付费且接受免费额度抵扣。
  * 余额不足，该接口需要付费且不接受免费额度抵扣。
* **429 Too Many Requests（请求过多）**
  * 请求速度过快，超出频率限制。
* **500 Internal Server Error（服务器内部错误）**
  * 服务器内部错误，无法完成请求。

---

#### API 令牌介绍

##### 方式一：在请求头中使用 API 令牌（推荐）

- **Header**：`Authorization`
- **格式**：`Bearer your_token`
- **示例**：`"Authorization": "Bearer your_token"`
- **Swagger UI**：点击页面右上角的 `Authorize` 按钮，直接输入 API 令牌即可，无需添加 `Bearer` 关键字。

##### 方式二：在 Cookie 中使用 API 令牌（不推荐，仅在方式一不可用时使用）

- **Cookie**：`Authorization`
- **格式**：`Bearer your_token`
- **示例**：`Authorization=Bearer your_token`

#### 获取 API 令牌

1. 在 TikHub 官网注册并登录您的账户。
2. 进入用户中心，点击 API 令牌菜单，创建一个 API 令牌。
3. 复制该令牌并在请求头中使用。
4. 请妥善保管您的 API 令牌，仅在请求头中使用。