API Reference

Todos los endpoints viven bajo https://api.soma9.cloud.

Autenticación

SOMA9 usa cookies sesión firmadas (Better-Auth). El cookie es cross-subdomain entre panel.soma9.cloud y api.soma9.cloud. Para integraciones server-to-server, usá un token de API generado en /dashboard/profile (próximamente).

Convenciones

• Todas las respuestas son application/json.
• Errores siguen el formato:

  { "error": "BadRequest", "message": "...", "statusCode": 400 }

• Las fechas son ISO 8601 UTC.
• Los precios son enteros en céntimos. Currency en campo separado.

Rate limit

• Global: 300 req / minuto / IP.
• /auth/*: 20 req / minuto / IP (anti brute force).

Headers de respuesta:

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 287
X-RateLimit-Reset: 42

Secciones

• Auth — login, magic link, 2FA, sesiones.
• Domains — search, register, DNS, DNSSEC, history.
• Webhooks salientes — suscribirte a eventos, verificar firma.
• Mail — activar dominio, crear cuentas, alias.