GET /dns – ferrixx API

DNS Lookup

Führt einen DNS-Lookup für einen beliebigen Hostnamen durch. Unterstützt A, AAAA, MX, NS, TXT, CNAME und SOA Records.

GET /v1/dns ping.custom

Parameter

Parameter	Typ	Pflicht	Beschreibung
`host`	string	ja	Hostname für den Lookup (z.B. `example.com`)
`type`	string	nein	Record-Typ (Standard: `A`)

Unterstützte Typen:

A AAAA MX NS TXT CNAME SOA

Beispiel-Requests

# A-Record (IPv4)
curl -H "X-API-Key: apk_dein_key" \
     "https://api.ferrixx.de/v1/dns?host=example.com"

# MX-Records (Mail)
curl -H "X-API-Key: apk_dein_key" \
     "https://api.ferrixx.de/v1/dns?host=example.com&type=MX"

# AAAA-Record (IPv6)
curl -H "X-API-Key: apk_dein_key" \
     "https://api.ferrixx.de/v1/dns?host=example.com&type=AAAA"

Beispiel-Antworten

A-Record

{
  "success": true,
  "message": "OK",
  "data": {
    "host": "example.com",
    "type": "A",
    "records": [
      { "ttl": 3600, "ip": "93.184.216.34" }
    ],
    "count": 1,
    "latency_ms": 18.4
  },
  "timestamp": "2026-06-01T12:00:00+00:00"
}

MX-Record

{
  "success": true,
  "message": "OK",
  "data": {
    "host": "example.com",
    "type": "MX",
    "records": [
      { "ttl": 3600, "target": "mail.example.com", "pri": 10 }
    ],
    "count": 1,
    "latency_ms": 22.1
  },
  "timestamp": "2026-06-01T12:00:00+00:00"
}

Keine Records gefunden

{
  "success": true,
  "message": "OK",
  "data": {
    "host": "nxdomain.example.com",
    "type": "A",
    "records": [],
    "count": 0,
    "latency_ms": 5.2
  },
  "timestamp": "2026-06-01T12:00:00+00:00"
}