Esta página reúne lo que necesitas para usar la API Feed de dominios sin escribirnos: cómo obtener y usar tu llave, qué límites tiene tu plan, qué significa cada error y qué hacer si pierdes la llave. Cada endpoint, con sus parámetros y ejemplos, está en la referencia del feed de dominios.
Primeros pasos
- Suscríbete. Elige un plan en la página del feed. El plan Pro mensual incluye 7 días de prueba gratis.
- Abre el enlace de tu correo. Al pagar, o al iniciar la prueba, te llega un correo con un enlace de un solo uso a la dirección de la compra. Tiene una vigencia limitada (hoy, 72 horas).
- Reclama tu llave. En la página del enlace, pulsa el botón para ver tu llave. Se muestra una sola vez: cópiala y guárdala en un gestor de secretos o en una variable de entorno. Cifradia solo guarda una huella de la llave y no puede mostrártela de nuevo.
- Haz tu primera petición.
export KEY="<tu llave>"
curl -H "Authorization: Bearer $KEY" "https://api.cifradia.com/v1/tlds"Si recibes un JSON con "status": true, ya estás dentro. Si no, revisa los errores.
Autenticación
- Cada petición lleva la cabecera
Authorization: Bearer <tu llave>. Las llaves empiezan porcfd_live_. - Nunca pongas la llave en la URL. Las URL quedan en historiales, registros de proxies y cabeceras
Referer. La API solo acepta la llave en la cabecera. - Hay una llave por suscripción. Es personal e intransferible; trátala como una contraseña y no la subas a repositorios ni la uses en código que se ejecute en un navegador.
- Si ya habías usado una prueba gratis antes, tu llave nueva se puede reclamar, pero responde
401hasta tu primer pago (sección 10 de los términos de la API).
Planes y límites
La tabla de planes muestra para cada plan las peticiones por minuto y por día, los días de historial, los TLD incluidos y si incluye el ZIP diario.
- Por minuto: si superas el límite, la API responde
429y la cabeceraRetry-Afterindica cuántos segundos esperar. - Por día: la cuota se reinicia a las 00:00 UTC. Al agotarla, la API responde
429yRetry-Afterindica los segundos hasta ese momento. - Qué cuenta: las peticiones con llave válida que pasan el límite por minuto, incluidas las que terminan en
400o403. Las que terminan en401o429no gastan cuota. - Cabeceras: las respuestas a peticiones con llave válida traen
RateLimit-Limit,RateLimit-RemainingyRateLimit-Resetsi tu llave tiene límite por minuto, yX-Daily-Quota-LimityX-Daily-Quota-Remainingsi tiene cuota diaria, para que sepas cuánto te queda. - Fuera del plan: pedir un TLD que tu plan no incluye, una fecha anterior a tu historial o el ZIP diario sin tenerlo da
403. Superar un límite no genera cobros adicionales.
Si no quieres chocar con el límite, espacia las peticiones y reintenta solo después de Retry-After, no en bucle.
Errores
Los errores llevan un código HTTP y un JSON con una descripción. Estos son los que devuelve la API:
| Código | Cuándo ocurre | Qué hacer |
|---|---|---|
400 | Un valor no es válido: una fecha que no es | Corrige la petición. El campo |
401 | Falta la llave, es incorrecta, fue revocada (por ejemplo, tras cancelar) o está suspendida. | Revisa la cabecera |
403 | Tu plan no incluye lo que pides: un TLD, una fecha anterior a tu historial o el ZIP diario. | Pide solo lo que incluye tu plan o cambia de plan. |
404 | Sin | Reintenta más tarde, o escríbenos si es un enlace de reclamo. |
422 | Un parámetro no tiene el tipo o el rango correcto: un entero que no lo es, un
| Corrige la petición. |
429 | Superaste el límite por minuto o la cuota diaria. | Espera los segundos de |
503 | La consulta es demasiado pesada o el servicio está ocupado. Trae | Reduce el rango de fechas o los filtros, o reintenta tras |
Las respuestas de error 400, 401, 403, 404 y 429 tienen esta forma:
{ "detail": { "status": false, "error": "rate limit exceeded" } }Un 422 trae en detail una lista con el parámetro (loc), el motivo (msg) y el tipo (type). Un 503 por consulta pesada trae { "status": false, "error": "…" } sin detail. Un error interno (500) es un fallo nuestro, no de tu petición: reintenta y, si persiste, escríbenos.
Cuándo hay datos
Los datos se actualizan una vez al día. La sincronización empieza a las 07:00 UTC y hoy tarda unos 25 minutos, así que lo habitual es tener los cambios del día anterior hacia las 07:30 UTC. Es una referencia, no una garantía de horario. Si consultas antes, los cambios del día anterior pueden no estar todavía; sin date, la API devuelve el último día con datos. En los términos de la API está el alcance del servicio.
Facturación y cancelación
- El pago lo procesa Paddle, nuestro revendedor, que emite la factura y gestiona los impuestos.
- Puedes cancelar cuando quieras desde el portal de cliente de Paddle o desde el enlace de sus correos. El acceso sigue hasta el final del periodo pagado y después la llave se revoca. Detalle en la sección Cancelación.
- Para pedir un reembolso, mira la sección Reembolsos: incluye el retracto de 5 días hábiles tras tu primer pago y el reembolso por falla del servicio.
- Para cambiar de plan o de ciclo, escríbenos desde el correo de la suscripción (cambio de plan). La llave se conserva y toma los límites del plan nuevo.
Llave perdida o comprometida
Cifradia no puede recuperar una llave, pero sí darte una nueva. Escríbenos a contacto@cifradia.com desde el correo de tu suscripción y te enviaremos un enlace nuevo para reclamarla. La llave anterior deja de funcionar, así que actualiza tus integraciones cuando la recibas (llaves de acceso).
Si sospechas que alguien más conoce tu llave, avísanos cuanto antes para reemplazarla.
Contacto
Escríbenos a contacto@cifradia.com o por la página de contacto. Atendemos de lunes a viernes de 8:00 a 18:00 (hora de Bogotá). Para que podamos ayudarte rápido, incluye el correo de la suscripción, el endpoint y los parámetros que usaste, el código de error y la hora aproximada (UTC). Nunca nos envíes tu llave completa.