🌐 documentación
Dominios custom con SSL automático
Dale a cada cliente de tu SaaS su propio dominio con HTTPS sin tocar certificados:
- Registrás el hostname y su destino interno:
curl -X POST https://tudominio.com/api/v1/domains \
-H "x-api-key: TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "domainName": "app.cliente.com", "targetUrl": "http://mi-backend:3000" }'
- Tu cliente apunta su DNS (CNAME al anchor, o A al servidor).
- En la primera visita, Caddy consulta a la API si el dominio está autorizado y emite el certificado SSL en segundos (TLS on-demand).
El proxy inyecta headers de tenant (X-Tenant-*) hacia tu backend, así una sola
instancia atiende a todos tus clientes white-label.
| Endpoint | Descripción |
|---|---|
POST /api/v1/domains | Registrar hostname |
GET /api/v1/domains | Listar y ver estado de verificación |
POST /api/v1/domains/:id/verify | Forzar verificación DNS |
Comprar dominios (registrar integrado)
También podés comprar dominios sin salir de CloudWapp (integración Namecheap):
cloudwapp domains check midominio.com # disponibilidad y precio
cloudwapp domains register midominio.com # compra + DNS apuntado a tu server
Los subdominios de tus apps (mi-app.apps.tudominio.com) se enrutan solos en cada
deploy — no hay que configurar nada.