API DNS

API DNS

Questa guida spiega come utilizzare la nostra API DNS.

Passo 1: Attivare lx27accesso API

Prima di poter utilizzare lx27API DNS, vai su admin.firestorm.ch e accedi con il tuo ID FireStorm. Attiva lx27API DNS sotto Account => Profilo cliente => Accesso API.

Passo 2: Copiare la chiave API

Dopo lx27attivazione, verrà visualizzata la tua chiave API personale. Copia questa chiave e utilizzala per tutte le richieste API.

Passo 3: Utilizzare lx27API

Utilizza la chiave API nellx27header X-API-Key:

curl -H "X-API-Key: TUA_CHIAVE_API" https://api.firestorm.ch/dns/v1/zones

Endpoint API

Zone

Record individuali

Esempi

Ottenere lx27ID della zona

curl -H "X-API-Key: TUA_CHIAVE_API" https://api.firestorm.ch/dns/v1/zones

Risposta:

{
    "status": "OK",
    "zones": [
        {"id": 123, "name": "example.ch"},
        {"id": 456, "name": "example.com"}
    ]
}

Elencare i record

curl -H "X-API-Key: TUA_CHIAVE_API" https://api.firestorm.ch/dns/v1/zone/123/records

Aggiungere un record

curl -X POST -H "X-API-Key: TUA_CHIAVE_API" -H "Content-Type: application/json" \
  -d x27{"name":"test.example.ch.","type":"A","data":"192.168.1.1","ttl":3600}x27 \
  https://api.firestorm.ch/dns/v1/zone/123/record

Modificare un record

curl -X PUT -H "X-API-Key: TUA_CHIAVE_API" -H "Content-Type: application/json" \
  -d x27{"name":"test.example.ch.","type":"A","old_data":"192.168.1.1","data":"192.168.1.2","ttl":3600}x27 \
  https://api.firestorm.ch/dns/v1/zone/123/record

Eliminare un record

curl -X DELETE -H "X-API-Key: TUA_CHIAVE_API" -H "Content-Type: application/json" \
  -d x27{"name":"test.example.ch.","type":"A","data":"192.168.1.2"}x27 \
  https://api.firestorm.ch/dns/v1/zone/123/record

Tipi di record consentiti

A, AAAA, CNAME, MX, TXT, NS, SRV, CAA, PTR

Validazione

• A: Deve essere un indirizzo IPv4 valido
• AAAA: Deve essere un indirizzo IPv6 valido
• CNAME: Deve essere un FQDN che termina con un punto (es. example.ch.)
• TXT: Automaticamente racchiuso tra virgolette
• TTL: Minimo 60, massimo 86400, predefinito 3600

ACME DNS-01 Challenge

Propagazione automatica: Per i record _acme-challenge.*, lx27API attende automaticamente che tutti i server DNS abbiano il record. La risposta contiene i dettagli della propagazione:

{
    "status": "OK",
    "record_id": 12345,
    "propagation": {
        "propagated": true,
        "time": 45,
        "servers": {
            "dns11.firestorm.ch": true,
            "dns12.firestorm-isp.com": true,
            "dns13.firestorm-isp.com": true,
            "dns14.firestorm.ch": true
        }
    }
}

Altri esempi

Per esempi PowerShell, vedi: Esempio PowerShell API DNS