> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ttapi.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Шлюз и авторизация

> Домены шлюза, правила запросов и способы аутентификации в TTAPI

## Обзор

Шлюз TTAPI - это единая точка входа для всех API-запросов. Он отвечает за маршрутизацию, аутентификацию и контроль трафика. Каждый запрос должен пройти проверку шлюза, иначе API вернет `401`.

<Callout type="info" title="Домены шлюза">
  ### Основные API-домены

  * **Основной**: `https://api.ttapi.io`
    * Рекомендуется для большинства запросов
  * **Ускоренный**: `https://api.ttapi.org`
    * Подходит для длительных синхронных запросов

  ### Домены Хостинг аккаунта Midjourney

  * **Основной**: `https://hold.ttapi.io`
  * **Ускоренный**: `https://hold.ttapi.org`

  ### Домены Claude Code

  * **Основной**: `https://cc.ttapi.io`
    * Рекомендуется для большинства запросов
  * **Ускоренный**: `https://cc.ttapi.org`
    * Подходит для длительных синхронных запросов
</Callout>

## Аутентификация

Во всех конечных точках TTAPI используется заголовок `TT-API-KEY`.

* Имя заголовка: `TT-API-KEY`
* Где передается: в HTTP-заголовке запроса
* Чувствительность к регистру: учитывается
* Где взять ключ: [TTAPI панель управления](https://dashboard.ttapi.io/)

## Правила запросов

| Параметр     | Требование                        |
| :----------- | :-------------------------------- |
| Протокол     | Только HTTPS                      |
| Метод        | Следуйте описанию конкретного API |
| Кодировка    | UTF-8                             |
| Content-Type | `application/json`                |

## Ошибки авторизации

| HTTP-код | Значение              | Что проверить                                              |
| :------- | :-------------------- | :--------------------------------------------------------- |
| `401`    | Ошибка аутентификации | Ключ отсутствует, неверный ключ или аккаунт не активирован |

#### Пример ответа с ошибкой

```json theme={null}
{
  "status": "FAILED",
  "message": "Wrong TT-API-KEY or email is not activated."
}
```
