API-Dokumentation

Greifen Sie auf unsere RESTful-API zu, um IPv6-Netzwerk-Diagnosetools in Ihre Anwendungen zu integrieren. Alle Endpunkte geben JSON-Antworten zurück und unterstützen sowohl IPv4 als auch IPv6.

Basis-URL

Bash

https://ping6.net/api/v1

Nur HTTPS

Alle API-Anfragen müssen HTTPS für sichere Kommunikation verwenden.

CORS Aktiviert

Cross-Origin-Anfragen werden von jeder Domain unterstützt.

Authentifizierung

Die meisten Endpunkte sind ohne Authentifizierung verfügbar. Für höhere Ratenlimits und Zugang zu Premium-Funktionen verwenden Sie einen API-Schlüssel.

Anonym

Keine Authentifizierung erforderlich. Unterliegt niedrigeren Ratenlimits.

API-Schlüssel

Fügen Sie Ihren API-Schlüssel im X-API-Key-Header für höhere Ratenlimits ein.

Bash

curl -X GET "https://ping6.net/api/v1/ping/google.com" \
  -H "X-API-Key: your-api-key-here"

Ratenlimits

API-Anfragen sind ratenlimitiert, um faire Nutzung und Dienstverfügbarkeit zu gewährleisten.

Stufe	Anfragen	Hinweise
Anonym	100 / minute	IP-basierte Limitierung. Geteilt unter allen anonymen Benutzern derselben IP.
API-Schlüssel	1,000 / minute	Pro API-Schlüssel. Kontaktieren Sie uns für höhere Limits.

Ratenlimit-Header

X-RateLimit-LimitMaximal erlaubte Anfragen pro Zeitfenster

X-RateLimit-RemainingVerbleibende Anfragen im aktuellen Zeitfenster

X-RateLimit-ResetUnix-Zeitstempel, wann das Ratenlimit zurückgesetzt wird

Fehlerbehandlung

Die API verwendet konventionelle HTTP-Antwortcodes, um Erfolg oder Misserfolg anzuzeigen.

Code	Status	Beschreibung
400	Bad Request	Ungültige Anfrageparameter oder fehlerhafter Anfragetext.
401	Unauthorized	Ungültiger oder fehlender API-Schlüssel für geschützte Endpunkte.
404	Not Found	Die angeforderte Ressource oder der Endpunkt existiert nicht.
429	Too Many Requests	Ratenlimit überschritten. Warten Sie, bevor Sie weitere Anfragen stellen.
500	Internal Server Error	Serverfehler. Bitte versuchen Sie es später erneut oder kontaktieren Sie den Support.

JSON

{
  "error": {
    "code": "INVALID_ADDRESS",
    "message": "The provided address is not a valid IPv6 address",
    "details": {
      "address": "invalid-address"
    }
  }
}

API-Endpunkte

GET/myip

Meine IP-Adresse Abrufen

Gibt die öffentliche IP-Adresse des anfragenden Clients zurück. Erkennt automatisch, ob die Verbindung IPv4 oder IPv6 ist.

Example Response

JSON

{
  "ip": "2001:db8:85a3::8a2e:370:7334",
  "version": 6,
  "isIPv6": true
}

Code Examples

cURL

curl -X GET "https://ping6.net/api/v1/myip" \
  -H "Accept: application/json"

GET/validate

IPv6-Adresse Validieren

Validiert eine IPv6-Adresse und gibt detaillierte Informationen über Format, Typ und kanonische Darstellungen zurück.

Parameters

Name	Type	In	Description
`address`*	string	query	Die zu validierende IPv6-Adresse

Example Response

JSON

{
  "valid": true,
  "type": "Documentation",
  "compressed": "2001:db8::1",
  "expanded": "2001:0db8:0000:0000:0000:0000:0000:0001"
}

Code Examples

cURL

curl -X GET "https://ping6.net/api/v1/validate?address=2001:db8::1" \
  -H "Accept: application/json"

GET/dns/{hostname}

DNS-Abfrage

DNS-Einträge für einen Hostnamen mit konfigurierbaren DNS-Resolvern abfragen. Unterstützt alle gängigen Eintragstypen mit besonderem Fokus auf AAAA-Einträge für IPv6.

Parameters

Name	Type	In	Description
`hostname`*	string	path	Der abzufragende Hostname
`type`	enum: AAAA \| A \| MX \| TXT \| NS \| CNAME \| SOA \| PTR	query	DNS-Eintragstyp zum Abfragen(default: `AAAA`)
`resolver`	enum: cloudflare \| google \| quad9	query	DNS-Resolver für die Abfrage(default: `cloudflare`)

Example Response

JSON

{
  "hostname": "google.com",
  "records": [
    {
      "type": "AAAA",
      "value": "2607:f8b0:4004:800::200e",
      "ttl": 300
    }
  ],
  "resolver": "cloudflare",
  "queryTime": 23
}

Code Examples

cURL

curl -X GET "https://ping6.net/api/v1/dns/google.com?type=AAAA&resolver=cloudflare" \
  -H "Accept: application/json"

GET/ping/{target}Beta

Ziel Pingen

Senden Sie ICMP-Echo-Anfragen an eine IPv6-Adresse oder einen Hostnamen und erhalten Sie Latenzstatistiken. Erfordert API-Schlüssel-Authentifizierung.

Parameters

Name	Type	In	Description
`target`*	string	path	IPv6-Adresse oder Hostname zum Pingen
`count`	string	query	Anzahl der zu sendenden Ping-Pakete (1-10)(default: `4`)

Example Response

JSON

{
  "target": "2001:4860:4860::8888",
  "ip": "2001:4860:4860::8888",
  "results": [
    {
      "seq": 1,
      "ttl": 117,
      "rtt": 12.4
    },
    {
      "seq": 2,
      "ttl": 117,
      "rtt": 11.8
    },
    {
      "seq": 3,
      "ttl": 117,
      "rtt": 12.1
    },
    {
      "seq": 4,
      "ttl": 117,
      "rtt": 11.9
    }
  ],
  "stats": {
    "transmitted": 4,
    "received": 4,
    "loss": 0,
    "min": 11.8,
    "avg": 12.05,
    "max": 12.4
  }
}

Code Examples

cURL

curl -X GET "https://ping6.net/api/v1/ping/2001:4860:4860::8888?count=4" \
  -H "Accept: application/json" \
  -H "X-API-Key: your-api-key"

GET/traceroute/{target}Beta

Traceroute

Verfolgen Sie den Netzwerkpfad zu einem Ziel und zeigen Sie jeden Hop entlang der Route mit Latenzinformationen an. Erfordert API-Schlüssel-Authentifizierung.

Parameters

Name	Type	In	Description
`target`*	string	path	IPv6-Adresse oder Hostname zum Verfolgen
`maxHops`	string	query	Maximale Anzahl der zu verfolgenden Hops (1-64)(default: `30`)

Example Response

JSON

{
  "target": "google.com",
  "ip": "2607:f8b0:4004:800::200e",
  "hops": [
    {
      "hop": 1,
      "ip": "2001:db8::1",
      "hostname": "router.local",
      "rtt": 1.2
    },
    {
      "hop": 2,
      "ip": "2001:db8:1::1",
      "hostname": "isp-gateway.net",
      "rtt": 5.4
    },
    {
      "hop": 3,
      "ip": "2607:f8b0:4004:800::200e",
      "hostname": "google.com",
      "rtt": 12.8
    }
  ]
}

Code Examples

cURL

curl -X GET "https://ping6.net/api/v1/traceroute/google.com?maxHops=30" \
  -H "Accept: application/json" \
  -H "X-API-Key: your-api-key"