API DNS

API DNS

Ce guide vous explique comment utiliser notre API DNS.

Etape 1 : Activer lx27accès API

Avant de pouvoir utiliser lx27API DNS, rendez-vous sur admin.firestorm.ch et connectez-vous avec votre identifiant FireStorm. Activez lx27API DNS sous Compte => Profil client => Accès API.

Etape 2 : Copier la clé API

Après lx27activation, votre clé API personnelle sera affichée. Copiez cette clé et utilisez-la pour toutes les requêtes API.

Etape 3 : Utiliser lx27API

Utilisez la clé API dans le header X-API-Key :

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

Points de terminaison API

Zones

Enregistrements individuels

Exemples

Obtenir lx27ID de zone

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

Réponse :

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

Lister les enregistrements

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

Ajouter un enregistrement

curl -X POST -H "X-API-Key: VOTRE_CLE_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

Modifier un enregistrement

curl -X PUT -H "X-API-Key: VOTRE_CLE_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

Supprimer un enregistrement

curl -X DELETE -H "X-API-Key: VOTRE_CLE_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

Types dx27enregistrement autorisés

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

Validation

• A : Doit être une adresse IPv4 valide
• AAAA : Doit être une adresse IPv6 valide
• CNAME : Doit être un FQDN se terminant par un point (p.ex. example.ch.)
• TXT : Automatiquement entouré de guillemets
• TTL : Minimum 60, maximum 86400, par défaut 3600

ACME DNS-01 Challenge

Propagation automatique : Pour les enregistrements _acme-challenge.*, lx27API attend automatiquement que tous les serveurs DNS aient lx27enregistrement. La réponse contient les détails de propagation :

{
    "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
        }
    }
}

Autres exemples

Pour des exemples PowerShell, voir : Exemple PowerShell API DNS