DNS API

DNS API används för att läsa tillgängliga zoner och tillhörande metadata.

Cachemodell (2026-03-27)

• DNS-zoncachen lagras nu radvis i databasen istället för som en enda bulkblob.
• Nya tabeller:
  • dns_zone_cache_records (en rad per DNS-post)
  • dns_zone_cache_ip_extras (index för extra IP, inklusive rättvänd reverse-owner-IP)
• POST /api/dns/records/add|delete|update|bulk synkar nu cache-rader efter bekräftad lyckad uppdatering mot master DNS.
• Automatisk invalidate är default avstängd per zon. När den aktiveras är standardintervall var tredje dag (259200 sekunder).
• Schemalagd invalidate hanteras via kommandot dns:cache:invalidate och påverkar endast zoner där policy är aktiverad och due.
• Manuell POST /api/dns/zones/{zone}/cache/clear är nu också policy-styrd fallback: den är default avstängd och fungerar först när invalidate aktiverats för zonen.

Autentisering

Använd API-nyckel i Authorization-header:

Authorization: Bearer YOUR_API_KEY

Vanliga anrop

Lista zoner

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://tools.tornevall.com/api/dns/zones"

Hämta en zon

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://tools.tornevall.com/api/dns/zones/example.com"

Felhantering

• 401 om nyckel saknas/är ogiltig
• 403 om nyckeln saknar åtkomst
• 429 vid rate limit

Tips

• Rotera nycklar regelbundet
• Använd separata nycklar för olika integrationer