Documentation de l'API

Accédez à notre API RESTful pour intégrer les outils de diagnostic réseau IPv6 dans vos applications. Tous les endpoints renvoient des réponses JSON et supportent IPv4 et IPv6.

URL de Base

Bash

https://ping6.net/api/v1

HTTPS Uniquement

Toutes les requêtes API doivent utiliser HTTPS pour une communication sécurisée.

CORS Activé

Les requêtes cross-origin sont supportées depuis n'importe quel domaine.

Authentification

La plupart des endpoints sont disponibles sans authentification. Pour des limites de taux plus élevées et l'accès aux fonctionnalités premium, utilisez une clé API.

Anonyme

Aucune authentification requise. Soumis à des limites de taux inférieures.

Clé API

Incluez votre clé API dans l'en-tête X-API-Key pour des limites de taux plus élevées.

Bash

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

Limites de Taux

Les requêtes API sont limitées en taux pour garantir une utilisation équitable et la disponibilité du service.

Niveau	Requêtes	Notes
Anonyme	100 / minute	Limitation basée sur l'IP. Partagée entre tous les utilisateurs anonymes de la même IP.
Clé API	1,000 / minute	Par clé API. Contactez-nous pour des limites plus élevées.

En-têtes de Limite de Taux

X-RateLimit-LimitRequêtes maximales autorisées par fenêtre

X-RateLimit-RemainingRequêtes restantes dans la fenêtre actuelle

X-RateLimit-ResetHorodatage Unix de réinitialisation de la limite

Gestion des Erreurs

L'API utilise des codes de réponse HTTP conventionnels pour indiquer le succès ou l'échec.

Code	Statut	Description
400	Bad Request	Paramètres de requête invalides ou corps de requête mal formé.
401	Unauthorized	Clé API invalide ou manquante pour les endpoints protégés.
404	Not Found	La ressource ou l'endpoint demandé n'existe pas.
429	Too Many Requests	Limite de taux dépassée. Attendez avant de faire plus de requêtes.
500	Internal Server Error	Erreur serveur. Veuillez réessayer plus tard ou contacter le support.

JSON

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

Endpoints de l'API

GET/myip

Obtenir Mon Adresse IP

Retourne l'adresse IP publique du client faisant la requête. Détecte automatiquement si la connexion est IPv4 ou IPv6.

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

Valider une Adresse IPv6

Valide une adresse IPv6 et retourne des informations détaillées sur son format, type et représentations canoniques.

Parameters

Name	Type	In	Description
`address`*	string	query	L'adresse IPv6 à valider

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}

Recherche DNS

Interrogez les enregistrements DNS pour un nom d'hôte en utilisant des résolveurs DNS configurables. Supporte tous les types d'enregistrements courants avec un focus spécial sur les enregistrements AAAA pour IPv6.

Parameters

Name	Type	In	Description
`hostname`*	string	path	Le nom d'hôte à interroger
`type`	enum: AAAA \| A \| MX \| TXT \| NS \| CNAME \| SOA \| PTR	query	Type d'enregistrement DNS à interroger(default: `AAAA`)
`resolver`	enum: cloudflare \| google \| quad9	query	Résolveur DNS à utiliser pour la requête(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

Ping Cible

Envoyez des requêtes d'écho ICMP à une adresse IPv6 ou un nom d'hôte et recevez des statistiques de latence. Nécessite une authentification par clé API.

Parameters

Name	Type	In	Description
`target`*	string	path	Adresse IPv6 ou nom d'hôte à pinger
`count`	string	query	Nombre de paquets ping à envoyer (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

Tracez le chemin réseau vers une destination, montrant chaque saut le long de la route avec des informations de latence. Nécessite une authentification par clé API.

Parameters

Name	Type	In	Description
`target`*	string	path	Adresse IPv6 ou nom d'hôte à tracer
`maxHops`	string	query	Nombre maximum de sauts à tracer (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"