Documentação da API

Use endpoints confiáveis e de baixa latência em seus aplicativos.

PUB

Serviços públicos

Endpoints pequenos e confiáveis que dispensam conta: hora, endereço, país, câmbio e 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
Endpoints da API: 6
Escopo: Público
Experimentar
ME

Conta

De quem é o token e o que ele pode fazer.

GET /v1/account/me
GET /v1/account/sessions
POST /v1/account/sessions/revoke
POST /v1/account/sessions/revoke-all
POST /v1/account/profile
Endpoints da API: 5
Escopo: Bearer
Referência
DNS

DNS

Reivindique um domínio, comprove que o controla e gerencie os 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}
Endpoints da API: 10
Escopo: Bearer
Referência
KEY

Credenciais

O cofre privado de credenciais por trás da ferramenta de credenciais.

GET /v1/cred
POST /v1/cred
Endpoints da API: 2
Escopo: Bearer
Referência
FILE

Arquivos

Armazenamento pessoal: listar, enviar, editar, compartilhar e excluir.

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
Endpoints da API: 9
Escopo: Bearer
Referência
API

CDN

Cache na borda e tráfego dos arquivos que você compartilha.

GET /v1/cdn/stats
POST /v1/cdn/config
POST /v1/cdn/purge
Endpoints da API: 3
Escopo: Bearer
Referência
API

Encaminhamento de SMS

Mensagens retransmitidas do seu telefone e as chaves que permitem isso.

GET /v1/sms/messages
GET /v1/sms/keys
POST /v1/sms/keys
DELETE /v1/sms/keys
Endpoints da API: 4
Escopo: Bearer
Referência
API

Sites estáticos

Envie um zip e sirva um site.

GET /v1/sites
POST /v1/sites/deploy
POST /v1/sites/delete
Endpoints da API: 3
Escopo: Bearer
Referência
API

Implantações

Os endpoints de formulário, webhook e link curto que você publicou.

GET /v1/deployments
POST /v1/deployments/toggle
POST /v1/deployments/delete
Endpoints da API: 3
Escopo: Bearer
Referência
API

Domínios

Sua carteira de domínios e os dados de registro.

GET /v1/domains
POST /v1/domains/whois-sync
Endpoints da API: 2
Escopo: Bearer
Referência
PKG

Pacotes

Publique versões e consulte suas versões e totais de download.

GET /v1/packages
GET /v1/packages/{slug}
POST /v1/packages/publish
POST /v1/packages/update
POST /v1/packages/delete
Endpoints da API: 5
Escopo: Bearer
Referência
WHO

WHOIS

Dados de registro de um domínio, em cache e compartilhados com as ferramentas de domínio.

GET /v1/whois
Endpoints da API: 1
Escopo: Bearer
Referência

Primeiros passos

Endpoints públicos de utilitários, como hora, endereço IP e taxas de câmbio, são gratuitos e não exigem autenticação.

A API de Gerenciamento de DNS em /v1 exige um token Bearer de Conta → Chaves de API. Um token só pode acessar as zonas verificadas de seu proprietário.

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

Aponte um agente para /v1/ai e obtenha um resumo feito para colar direto em um prompt, ou para /v1/ai?format=json e receber os mesmos endpoints como definições de ferramentas. /v1/openapi.json é o contrato OpenAPI 3.1 completo e /llms.txt é o mapa para rastreadores. Os quatro são gerados a partir da mesma tabela de rotas desta página, então nenhum deles descreve um endpoint que não existe.