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

# Свои CDN-домены

> Как подключить свой домен к CDN команды.

Свой домен позволяет раздавать файлы команды по адресу вида `https://files.example.com/images/logo.png`. Для всех операций с доменами нужен доступ к управлению CDN команды.

**1. Привяжите ключ к команде**

Выполните `PUT /v3/cdn/team` с `teamId` вашей команды.

**2. Добавьте домен**

Выполните `POST /v3/cdn/custom-domains` с телом `{ "domain": "files.example.com", "s3Backup": true }`. В ответе будут DNS-записи для проверки.

**3. Настройте DNS**

Добавьте у регистратора записи из ответа: CNAME домена на `cname.erlcrussia.com` и запись для проверки владения.

**4. Проверьте домен**

Выполните `POST /v3/cdn/custom-domains/{id}/verify`. Домен готов, когда `isVerified` равно `true`, а статус сертификата `cfSslStatus` — `active`.

**5. Загрузите файл**

Передайте `domain=files.example.com` при загрузке через `POST /v3/cdn/assets` и откройте файл по адресу на своём домене.

## Управление

* `PATCH /v3/cdn/custom-domains/{id}` меняет внешний источник файлов (`originUrl`) и резервное копирование (`s3Backup`). Пустой `originUrl` отключает внешний источник.
* Домен с файлами удалить нельзя: сначала удалите файлы.
* Токен `deployHookToken` нужен для [сброса кэша из CI/CD](https://apidocs.erlcrussia.com/ru/tutorials/cdn-cache-purge-cicd.md). Храните его в секретах CI.
* Если проверка не проходит, убедитесь, что DNS-записи совпадают с ответом и успели обновиться.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.