Autenticación

La ReportedIP API utiliza la autenticación mediante API Key para identificar a los solicitantes y aplicar Rate Limits. Algunos Endpoints públicos funcionan sin autenticación, pero una API Key permite acceder a límites más altos y a funciones adicionales. Todos los Endpoints, parámetros y ejemplos de código están documentados en la API Reference .

Autenticación mediante API Key

Incluye tu API Key en cada solicitud autenticada. Existen dos métodos: se recomienda el X-Key encabezado, ya que mantiene tu clave fuera de los registros de acceso del servidor.

Método 1: Encabezado X-Key (recomendado)

curl -H "X-Key: YOUR_API_KEY" \
     "https://reportedip.com/wp-json/reportedip/v2/check?ip=1.2.3.4"

Método 2: Parámetro de consulta

curl "https://reportedip.com/wp-json/reportedip/v2/check?ip=1.2.3.4&key=YOUR_API_KEY"

Cómo obtener tu API Key

Sigue estos tres pasos para obtener tu API Key:

Roles de usuario y permisos

Tu API Key está vinculada a tu rol de usuario. Cada rol tiene diferentes Rate Limits y acceso a funciones. Al registrarte, empiezas con el rol «Free».

Rate Limits

Cada respuesta de la API incluye encabezados de Rate Limit para que puedas realizar un seguimiento de tu uso en tiempo real. Cuando superes tu límite, la API responderá con 429 Too Many Requests.

Ejemplo de encabezados de respuesta

HTTP/1.1 200 OK
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 742
X-RateLimit-Reset: 1711929600
Content-Type: application/json; charset=UTF-8

Autenticación híbrida

Endpoints públicos como /check-public, /search-public, y /stats-public funcionan sin necesidad de autenticación. No obstante, admiten una API Key opcional para desbloquear Rate Limits más altos.

# Without API key — 100 requests/day per IP
curl "https://reportedip.com/wp-json/reportedip/v2/check-public?ip=1.2.3.4"

# With API key — uses your role's daily limit
curl -H "X-Key: YOUR_API_KEY" \
     "https://reportedip.com/wp-json/reportedip/v2/check-public?ip=1.2.3.4"

Respuestas de error

Los errores de autenticación devuelven respuestas JSON estándar. Comprueba siempre meta.success y el código de estado HTTP.

401 No autorizado

Se devuelve cuando falta la API Key o esta no es válida.

{
  "meta": {
    "success": false,
    "code": 401,
    "message": "Invalid or missing API key."
  },
  "data": null
}

403 Prohibido

Se devuelve cuando tu rol no tiene permiso para el Endpoint solicitado.

{
  "meta": {
    "success": false,
    "code": 403,
    "message": "Your role does not have access to this endpoint."
  },
  "data": null
}

429 Demasiadas solicitudes

Se devuelve cuando se ha superado el Rate Limit diario.

{
  "meta": {
    "success": false,
    "code": 429,
    "message": "Rate limit exceeded. Try again later."
  },
  "data": {
    "retryAfter": 3600
  }
}

Prácticas recomendadas

Última actualización:August 6, 2026 · Gestionado por el equipo de reportedIP