Documentación de la API

Use endpoints fiables y de baja latencia en sus aplicaciones.

PUB

Servicios públicos

Endpoints pequeños y fiables que no requieren cuenta: hora, dirección, país, tipos de cambio y hashes.

GET /v1/public/time
GET /v1/public/timestamp
GET /v1/public/ip
GET /v1/public/geo
GET /v1/public/fx
GET /v1/public/hash
Puntos de conexión: 6
Ámbito: Público
Probar
ME

Cuenta

A quién pertenece un token y qué puede hacer.

GET /v1/account/me
GET /v1/account/sessions
POST /v1/account/sessions/revoke
POST /v1/account/sessions/revoke-all
POST /v1/account/profile
Puntos de conexión: 5
Ámbito: Bearer
Referencia
DNS

DNS

Reclama un dominio, demuestra que lo controlas y gestiona sus registros.

GET /v1/dns/zones
POST /v1/dns/zones
GET /v1/dns/zones/{zone}
POST /v1/dns/zones/{zone}/verify
DELETE /v1/dns/zones/{zone}
GET /v1/dns/zones/{zone}/records
POST /v1/dns/zones/{zone}/records
GET /v1/dns/zones/{zone}/records/{id}
PATCH /v1/dns/zones/{zone}/records/{id}
DELETE /v1/dns/zones/{zone}/records/{id}
Puntos de conexión: 10
Ámbito: Bearer
Referencia
KEY

Credenciales

El almacén privado de credenciales que hay detrás de la herramienta de credenciales.

GET /v1/cred
POST /v1/cred
Puntos de conexión: 2
Ámbito: Bearer
Referencia
FILE

Archivos

Almacenamiento personal de archivos: listar, subir, editar, compartir y eliminar.

GET /v1/files
GET /v1/files/{id}
GET /v1/files/download
POST /v1/files/upload
POST /v1/files/update
POST /v1/files/rename
POST /v1/files/delete
POST /v1/files/upload-chunk
POST /v1/files/upload-finalize
Puntos de conexión: 9
Ámbito: Bearer
Referencia
API

CDN

Caché en el borde y tráfico de los archivos que compartes.

GET /v1/cdn/stats
POST /v1/cdn/config
POST /v1/cdn/purge
Puntos de conexión: 3
Ámbito: Bearer
Referencia
API

Reenvío de SMS

Mensajes retransmitidos desde tu teléfono y las claves que lo permiten.

GET /v1/sms/messages
GET /v1/sms/keys
POST /v1/sms/keys
DELETE /v1/sms/keys
Puntos de conexión: 4
Ámbito: Bearer
Referencia
API

Sitios estáticos

Sube un zip y sirve un sitio.

GET /v1/sites
POST /v1/sites/deploy
POST /v1/sites/delete
Puntos de conexión: 3
Ámbito: Bearer
Referencia
API

Despliegues

Los endpoints de formulario, webhook y enlace corto que has desplegado.

GET /v1/deployments
POST /v1/deployments/toggle
POST /v1/deployments/delete
Puntos de conexión: 3
Ámbito: Bearer
Referencia
API

Dominios

Tu cartera de dominios y sus datos de registro.

GET /v1/domains
POST /v1/domains/whois-sync
Puntos de conexión: 2
Ámbito: Bearer
Referencia
PKG

Paquetes

Publica versiones y consulta sus versiones y totales de descargas.

GET /v1/packages
GET /v1/packages/{slug}
POST /v1/packages/publish
POST /v1/packages/update
POST /v1/packages/delete
Puntos de conexión: 5
Ámbito: Bearer
Referencia
WHO

WHOIS

Datos de registro de un dominio, en caché y compartidos con las herramientas de dominios.

GET /v1/whois
Puntos de conexión: 1
Ámbito: Bearer
Referencia

Primeros pasos

Los endpoints de utilidades públicas, como la hora, la dirección IP y los tipos de cambio, son gratuitos y no requieren autenticación.

La API de administración de DNS en /v1 requiere un token Bearer de Cuenta → Claves de API. Cada token solo puede acceder a las zonas verificadas de su propietario.

Endpoint público

fetch('https://api.c.nf/v1/public/time')
  .then(response => response.json())
  .then(data => console.log(data.data.iso8601));

Endpoint DNS v1 autenticado

fetch('https://api.c.nf/v1/dns/zones', {
  headers: { 'Authorization': 'Bearer cnf_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' }
})
  .then(r => r.json())
  .then(data => console.log(data.data.zones));

Para agentes de IA

Dirige un agente a /v1/ai para obtener un resumen pensado para pegarlo en un prompt, o a /v1/ai?format=json para los mismos endpoints como definiciones de herramientas. /v1/openapi.json es el contrato OpenAPI 3.1 completo y /llms.txt es el mapa para rastreadores. Los cuatro se generan a partir de la misma tabla de rutas que esta página, así que ninguno puede describir un endpoint que no existe.