Support Wissensdatenbank

DNS API

With this instruction we will explain you how to use our DNS API. The API uses Basic http Auth for authentication. Just log in with your FireStorm ID.

Request all zones

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

Answer:

{
    "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 Request:

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

Answer:

{
    "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 Refresh:

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

DATA

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

Answer:

{"status":"OK"}