Saltar al contenido principal
Un dominio propio sirve los archivos del equipo en direcciones como https://files.example.com/images/logo.png. Todas las operaciones con dominios requieren permiso de gestión de la CDN del equipo.
1

Vincula la clave al equipo

Llama a PUT /v3/cdn/team con el teamId de tu equipo.
2

Añade el dominio

Llama a POST /v3/cdn/custom-domains con { "domain": "files.example.com", "s3Backup": true }. La respuesta incluye los registros DNS a verificar.
3

Configura el DNS

Añade en tu registrador los registros de la respuesta: un CNAME del dominio a cname.erlcrussia.com y el registro de propiedad.
4

Verifica el dominio

Llama a POST /v3/cdn/custom-domains/{id}/verify. El dominio está listo cuando isVerified es true y cfSslStatus es active.
5

Sube un archivo

Indica domain=files.example.com al subir con POST /v3/cdn/assets y abre el archivo en tu dominio.

Gestión

  • PATCH /v3/cdn/custom-domains/{id} cambia el origen externo (originUrl) y la copia de seguridad (s3Backup). Un originUrl vacío desactiva el origen externo.
  • No se puede eliminar un dominio con archivos: elimínalos antes.
  • El deployHookToken sirve para purgar la caché desde CI/CD. Guárdalo en los secretos de CI.
  • Si la verificación falla, comprueba que los registros DNS coinciden con la respuesta y ya se propagaron.