API e integrazioni

API DNS REST di NorthDNS

Automatizza zone, record DNS, regole, analytics, cache e webhook con l’API v1 di NorthDNS e token limitati per dominio.

Base URL

L’API usa JSON ed è disponibile su https://northdns.it/api/v1. La disponibilità dipende dal piano del dominio; durante l’open beta è inclusa.

Autenticazione

Crea un token da Account → Token API. Limitalo a un dominio, assegna solo i permessi necessari e imposta una scadenza. Il token completo viene mostrato una sola volta: revocalo subito se viene esposto.

curl https://northdns.it/api/v1/zones \
  -H "Authorization: Bearer nd_IL_TUO_TOKEN" \
  -H "Accept: application/json"

Endpoint

`GET /zones`	Zone accessibili
`GET\|POST /zones/:domainId/records`	Elenca e crea record
`PATCH\|DELETE /zones/:domainId/records/:recordId`	Modifica ed elimina record
`GET\|POST /zones/:domainId/rules`	Regole del proxy
`PATCH\|DELETE /zones/:domainId/rules/:ruleId`	Modifica ed elimina regole
`GET /zones/:domainId/analytics`	Traffico
`GET\|PATCH /zones/:domainId/edge`	Cache e sicurezza
`POST /zones/:domainId/edge/purge`	Svuota la cache
`GET\|POST /zones/:domainId/webhooks`	Webhook

Creare un record

curl -X POST https://northdns.it/api/v1/zones/ID_DOMINIO/records \
  -H "Authorization: Bearer nd_IL_TUO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"www","type":"A","value":"203.0.113.10","ttl":300}'

Limiti e permessi

Le richieste sono limitate a 120 al minuto. I permessi disponibili sono zones:read, dns:read, dns:write, rules:read, rules:write, analytics:read, edge:read, edge:write, webhooks:read, webhooks:write. Ogni modifica compare nel registro attività del dominio.