Support Wissensdatenbank

DNS API

Mit dieser Anleitung erklären wir dir, wie du unsere DNS API verwenden kannst. Die API verwendet für die Authentifizierung Basic http Auth. Loge dich einfach mit deiner FireStorm-ID ein.

Alle Zonen abfragen

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

Antwort:

{
    "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": [
                {
                    …
                }
        },
}

Zone Abfrage:

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

Antwort:

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

Zone Aktualisieren:

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

DATA

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

Antwort:

{"status":"OK"}