> ## 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.

# Domini CDN personalizzati

> Come collegare il tuo dominio alla CDN del team.

Un dominio personalizzato serve i file del team a indirizzi come `https://files.example.com/images/logo.png`. Tutte le operazioni sui domini richiedono il permesso di gestione della CDN del team.

**1. Collega la chiave al team**

Chiama `PUT /v3/cdn/team` con il `teamId` del tuo team.

**2. Aggiungi il dominio**

Chiama `POST /v3/cdn/custom-domains` con `{ "domain": "files.example.com", "s3Backup": true }`. La risposta contiene i record DNS da verificare.

**3. Configura il DNS**

Aggiungi presso il registrar i record della risposta: un CNAME del dominio verso `cname.erlcrussia.com` e il record di proprietà.

**4. Verifica il dominio**

Chiama `POST /v3/cdn/custom-domains/{id}/verify`. Il dominio è pronto quando `isVerified` è `true` e `cfSslStatus` è `active`.

**5. Carica un file**

Passa `domain=files.example.com` al caricamento con `POST /v3/cdn/assets` e apri il file sul tuo dominio.

## Gestione

* `PATCH /v3/cdn/custom-domains/{id}` modifica l'origine esterna (`originUrl`) e il backup (`s3Backup`). Un `originUrl` vuoto disattiva l'origine esterna.
* Un dominio con file non si può eliminare: elimina prima i file.
* Il `deployHookToken` serve per [svuotare la cache dalla CI/CD](https://apidocs.erlcrussia.com/it/tutorials/cdn-cache-purge-cicd.md). Conservalo nei segreti della CI.
* Se la verifica non riesce, controlla che i record DNS coincidano con la risposta e si siano propagati.


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