domain.latino API

Autenticación

Envía tu clave de API como token Bearer. Crea y gestiona tus claves en la configuración de tu cuenta; la clave completa se muestra una sola vez al crearla, así que guárdala de forma segura.

Authorization: Bearer dpk_live_<selector>_<secret>

Las claves tienen el formato dpk_<env>_<selector>_<secret>, donde env es live o test.

Una sesión de navegador con la sesión iniciada puede llamar a los mismos endpoints; las escrituras autenticadas por sesión requieren además una cabecera X-CSRF-Token. Las solicitudes con token Bearer no la necesitan.

Ámbitos y límites de tasa

Cada clave lleva un conjunto de ámbitos. Una llamada debe hacerse con una clave que tenga el ámbito del endpoint. Los límites de tasa se aplican por ámbito y por clave.

Los ámbitos restringidos tienen doble control: una clave puede incluir el ámbito, pero las llamadas solo funcionan una vez que un administrador lo ha concedido a tu cuenta. Solicítalo desde la configuración de tu cuenta.

Zonas de dominio compatibles

Una sola cuenta y una sola clave API funcionan en todas las zonas siguientes — la URL base que llames selecciona la zona.

Inicio rápido

Dos llamadas rápidas para empezar:

# Comprobar un nombre
curl -s https://domain.latino/api/v1/check-domain \
  -H "Authorization: Bearer dpk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"domain":"acme.latino"}'

# Quién soy y qué puedo hacer
curl -s https://domain.latino/api/v1/account \
  -H "Authorization: Bearer dpk_live_…"

Endpoints

Todos los endpoints están activos. Los esquemas de solicitud y respuesta, los parámetros y los códigos de estado están descritos por completo en el documento OpenAPI.

Account

Domains

Catalog

Orders

Payment methods

Webhooks

Restricted

Para el contrato completo de solicitud/respuesta, importa la especificación OpenAPI: Descargar OpenAPI (JSON).

Webhooks

Registra un endpoint HTTPS y te enviaremos eventos firmados a medida que ocurran. El secreto de firma se muestra una sola vez al crearlo.

Enviamos el sobre del evento por POST como JSON:

{
  "id": "evt_…",
  "event": "payment.succeeded",
  "created": "2026-05-28T12:00:00+00:00",
  "data": { "order": { … } }
}

Verifica cada entrega recalculando el HMAC-SHA256 sobre el cuerpo bruto de la solicitud con tu secreto de firma y comparándolo en tiempo constante:

X-Domain-Pay-Signature: sha256=<HMAC_SHA256(raw_body, signing_secret)>

Las respuestas distintas de 2xx (o los tiempos de espera agotados) se reintentan con retroceso exponencial (1 min to 24 h) hasta 6 intentos. Tras 5 entregas fallidas consecutivas, el endpoint se desactiva automáticamente y se avisa a su propietario.

Errores

Todos los errores comparten una misma estructura. El request_id se devuelve en cada error; indícalo en tus solicitudes de soporte.

{ "error": "scope_required", "message": "…", "request_id": "req_ab12…", "scope": "orders.read" }

Acceso restringido

Los endpoints de zone-file, premium y registrados requieren una concesión aprobada además del ámbito:

1. Crea (o ten ya) una clave de API que incluya el ámbito restringido.
2. En la configuración de tu cuenta, abre Acceso restringido a la API, elige el ámbito y explica cómo usarás los datos.
3. Nuestro equipo lo revisa y te envía una decisión por correo electrónico.
4. Una vez aprobado, cualquier clave de tu cuenta que incluya ese ámbito podrá usarlo de inmediato. Sin nivel de pago: la aprobación es por cuenta.