Documentación de la API

Accede a nuestra API RESTful para integrar herramientas de diagnóstico de red IPv6 en tus aplicaciones. Todos los endpoints devuelven respuestas JSON y soportan tanto IPv4 como IPv6.

URL Base

Bash

https://ping6.net/api/v1

Solo HTTPS

Todas las solicitudes de API deben usar HTTPS para comunicación segura.

CORS Habilitado

Las solicitudes cross-origin están soportadas desde cualquier dominio.

Autenticación

La mayoría de los endpoints están disponibles sin autenticación. Para límites de tasa más altos y acceso a funciones premium, usa una clave API.

Anónimo

No se requiere autenticación. Sujeto a límites de tasa más bajos.

Clave API

Incluye tu clave API en el encabezado X-API-Key para límites de tasa más altos.

Bash

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

Límites de Tasa

Las solicitudes de API están limitadas para garantizar un uso justo y la disponibilidad del servicio.

Nivel	Solicitudes	Notas
Anónimo	100 / minute	Limitación basada en IP. Compartida entre todos los usuarios anónimos de la misma IP.
Clave API	1,000 / minute	Por clave API. Contáctanos para límites más altos.

Encabezados de Límite de Tasa

X-RateLimit-LimitSolicitudes máximas permitidas por ventana

X-RateLimit-RemainingSolicitudes restantes en la ventana actual

X-RateLimit-ResetMarca de tiempo Unix cuando se reinicia el límite

Manejo de Errores

La API usa códigos de respuesta HTTP convencionales para indicar éxito o fallo.

Código	Estado	Descripción
400	Bad Request	Parámetros de solicitud inválidos o cuerpo de solicitud mal formado.
401	Unauthorized	Clave API inválida o faltante para endpoints protegidos.
404	Not Found	El recurso o endpoint solicitado no existe.
429	Too Many Requests	Límite de tasa excedido. Espera antes de hacer más solicitudes.
500	Internal Server Error	Error del servidor. Por favor intenta más tarde o contacta soporte.

JSON

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

Endpoints de la API

GET/myip

Obtener Mi Dirección IP

Devuelve la dirección IP pública del cliente que realiza la solicitud. Detecta automáticamente si la conexión es IPv4 o 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

Validar Dirección IPv6

Valida una dirección IPv6 y devuelve información detallada sobre su formato, tipo y representaciones canónicas.

Parameters

Name	Type	In	Description
`address`*	string	query	La dirección IPv6 a validar

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}

Consulta DNS

Consulta registros DNS para un nombre de host usando resolutores DNS configurables. Soporta todos los tipos de registros comunes con enfoque especial en registros AAAA para IPv6.

Parameters

Name	Type	In	Description
`hostname`*	string	path	El nombre de host a consultar
`type`	enum: AAAA \| A \| MX \| TXT \| NS \| CNAME \| SOA \| PTR	query	Tipo de registro DNS a consultar(default: `AAAA`)
`resolver`	enum: cloudflare \| google \| quad9	query	Resolutor DNS a usar para la consulta(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 a Objetivo

Envía solicitudes de eco ICMP a una dirección IPv6 o nombre de host y recibe estadísticas de latencia. Requiere autenticación con clave API.

Parameters

Name	Type	In	Description
`target`*	string	path	Dirección IPv6 o nombre de host a hacer ping
`count`	string	query	Número de paquetes ping a enviar (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

Traza la ruta de red hacia un destino, mostrando cada salto a lo largo de la ruta con información de latencia. Requiere autenticación con clave API.

Parameters

Name	Type	In	Description
`target`*	string	path	Dirección IPv6 o nombre de host a trazar
`maxHops`	string	query	Número máximo de saltos a trazar (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"