Support Wissensdatenbank

API DNS

Avec cette instruction, nous allons vous expliquer comment utiliser notre API DNS. L’API utilise Basic http Auth pour l’authentification. Il suffit de se connecter avec votre ID FireStorm.

Demander toutes les zones

GET	https://api.firestorm.ch/dns/v1/zones

Réponse:

{
    "status": "OK",
    "zones": [
        {
            "id": 14730,
            "name": "musterdomain.ch",
            "records": [
                {
                    "name": "*.musterdomain.ch.",
                    "ttl": "600",
                    "class": "IN",
                    "type": "A",
                    "data": "188.40.216.33"
                },
                {
                    "name": "a.b.c.musterdomain.ch.",
                    "ttl": "600",
                    "class": "IN",
                    "type": "A",
                    "data": "1.1.1.1"
                },
                …
            "created_at": "2019-09-30 11:32:33",
            "updated_at": "2021-06-15 10:51:09"
        },
        {
            "id": 19639,
            "name": "testzones123.ch",
            "records": [
                {
                    …
                }
        },
}

Demande de zone :

GET	https://api.firestorm.ch/dns/v1/zone/(zone ID)

Réponse:

{
    "status": "OK",
    "zone": [
        {
            "id": 19639,
            "name": "testzones123.ch",
            "records": [
                {
                    "name": "testzones123.ch.",
                    "ttl": "86400",
                    "class": "IN",
                    "type": "SOA",
                    "data": "dns11.firestorm.ch., info.firestorm.ch., 2021102830, 10800, 3600, 604800, 3600"
                },
                {
                    "name": "efg.testzones123.ch.",
                    "ttl": "86400",
                    "class": "IN",
                    "type": "TXT",
                    "data": "Testrecord123"
                }
            ],
            "created_at": "2021-09-24 10:04:23",
            "updated_at": "2021-09-24 10:04:23"
        }
    ]
}

Actualiser la zone :

PUT	https://api.firestorm.ch/dns/v1/zone/(zone id)

DATA

[{"name": "efg.testzones123.ch.","ttl": "86400","class": "IN","type": "TXT","data": "Testrecord123Z"}]

Réponse:

{"status":"OK"}