Skip to main contentSkip to footer
reportedIP
Developer Documentation: ReportedIP REST API y su ecosistema
API v2

Changelog

Historial completo de los cambios en la API, las nuevas funciones y las funciones obsoletas. Seguimos el sistema de versionado semántico; las versiones principales pueden introducir cambios que requieran una actualización.

v2.5.1, mayo de 2026

  • Se ha corregido el error por el que los contadores de cuota ya no contabilizaban dos veces el mismo valor. POST /report Antes, en una misma llamada se incrementaban tanto el contador de comprobaciones diarias como el de informes diarios, lo que consumía la cuota de comprobaciones cada vez que un cliente informaba de una IP. /report Ahora solo se consume la cuota de informes; la cuota de comprobación se reserva para las consultas de reputación reales.
  • Corregido POST /bulk-check Ahora se descuenta N de la cuota de comprobaciones diarias, donde N es el número de direcciones IP válidas de la solicitud (antes se descontaba +1 independientemente del tamaño del Payload). Las llamadas que superarían la cuota restante devuelven un código HTTP 429 sin incrementar el contador.
  • Corregido POST /bulk-report Ahora se deduce N de la cuota diaria de informes, donde N es el número de informes enviados (antes no se incrementaba en absoluto el contador de informes). Las llamadas que superarían la cuota restante devuelven un código HTTP 429 antes de que se inserte ningún informe.
  • Corregido: los endpoints de funciones con acceso por niveles (GET /blacklist, /blacklist-categories, /blacklist-stats, /reports/{ip}, /trends) ya no consumen la cuota de comprobaciones. Se comercializan como funciones independientes de «Threat Feed» / análisis en el plan de precios y nunca se pretendió que contaran como comprobaciones.
  • Corregido: protección de idempotencia de la causa raíz. El núcleo de WordPress invoca la permission_callback dos veces por solicitud: una vez durante el «dispatch» y una segunda vez desde rest_send_allow_header() en el rest_post_dispatch filtro para construir el Allow: encabezado. Esto provocaba que cada llamada autenticada consumiera dos veces la cuota de comprobaciones. Ahora, la protección omite el segundo incremento cuando el primero ya se ha realizado con éxito para la misma solicitud.
  • La página de API Reference modificada documenta ahora el coste en cuota de cada Endpoint en línea («Carga +1 a la cuota de comprobación», «Carga +N a la cuota de Reports» o «No cuenta para ninguna cuota diaria»). Un recuadro resumen en la parte superior de la página enumera qué Endpoints afectan a qué contador.

v2.5.0, mayo de 2026

  • Se ha añadido bundle_balance, bundle_eligible, inclusive_limit, inclusive_used y inclusive_available en /relay-quota, /relay-mail las /relay-sms respuestas tanto para correo electrónico como para SMS: ahora los clientes pueden mostrar el saldo del paquete de prepago junto al contador mensual incluido.
  • Se han añadido Nivel superior mail_bundle_balance y sms_bundle_balance en /relay-quota. Este último complementa el campo existente que los clientes Hive más antiguos ya leían, pero que el servicio no rellenaba.
  • Se ha añadido documentación pública para los endpoints de retransmisión de 2FA (GET /relay-quota, POST /relay-mail, POST /relay-sms), que incluye autenticación, parámetros, ejemplos y la matriz completa de errores HTTP (401 / 402 / 403 / 429).
  • Se ha modificado /relay-quota ahora expone el saldo del paquete de prepago para que el Dashboard de Hive pueda mostrar la línea «+ X créditos en el saldo de tu paquete» tanto para el correo electrónico como para los SMS.
  • Nota bundle_balance es un entero con signo. Los cargos reembolsados generan saldos negativos que bloquean nuevos envíos hasta que se adquiera un nuevo paquete; se trata de la protección contra reembolsos de Stripe documentada (charge.refunded Webhook).

v2.4.0, mayo de 2026

  • Se ha añadido Página pública de tarifas con código corto [reportedip_pricing]: comparación de planes en paralelo, opción de cambiar entre mensual y anual, Stripe Checkout integrado para actualizaciones.
  • Se han añadido los KPI destacados del Dashboard: panel de visión general que muestra el plan activo, las comprobaciones de la API de hoy, los informes de hoy y los límites de correo electrónico/SMS de la autenticación 2FA con barras de progreso.
  • Añadido Navegación unificada por el área de miembros a través de [reportedip_user_nav] las páginas del Dashboard, «My Logs», «Tarifas», «Docs» y «Cuenta».
  • Se ha añadido la autovigilancia del flujo de trabajo de Cron: tarea de pulso, detección de profundidad de cola (correo electrónico/SMS/Stripe/reputación), detector de bloqueos y supervisión diaria.
  • Se ha añadido un Endpoint de activación de Cron externo POST /v1/cron/tick con autenticación mediante token de portador como alternativa cuando WP-Cron se bloquea.

v2.3.0, abril de 2026

  • Se ha añadido el nivel «Business» a 39 € al mes (389 € al año): 100 000 comprobaciones de API al día, 5.000 informes al día, 15 dominios, 2.500 correos de 2FA incluidos al mes, 75 SMS de 2FA incluidos al mes, Setup Wizard de marca blanca, integración con WooCommerce, GDPR Export Tool y Priority Support con un SLA de 12 horas.
  • Se ha añadido la integración de facturación con Stripe: proceso de pago de suscripciones para los planes PRO y Business plan, portal de clientes de Stripe para la gestión de planes, facturación automatizada y SMS Bundles (50 / 200 / 500).
  • Se ha añadido el Mail Relay de 2FA: entrega SMTP gestionada para los correos de autenticación del plugin Hive; 500 incluidos para el plan PRO, 2.500 para el plan Business y uso Unlimited bajo condiciones de uso razonable para el plan Enterprise.
  • Se ha añadido el SMS Relay de 2FA (reenvío gestionado por reportedIP) con entrega a nivel mundial, salvo los países incluidos en una Blocklist interna (protección contra el fraude en las llamadas), con 25 mensajes incluidos para el plan PRO, 75 para el plan Business y paquetes de prepago disponibles.
  • Se han añadido nuevos endpoints REST en /v2/billing/*: checkout-session, portal-session, subscription, invoices, sms-credits, enterprise-request, reactivate-subscription.
  • Se ha añadido un flujo de trabajo de solicitudes de autoservicio para Enterprise con proceso de pago con precios personalizados a través de una enterprise_request_id rama dedicada.
  • Modificado : se han aumentado los límites por nivel: PRO ahora es de 25 000 comprobaciones/día · 1 000 Reports/día · 3 dominios (antes era 25 000 / 1 000 / 1).

v2.2.0, febrero de 2026

  • Modificado Cambio de marca del complemento Hive: el complemento de WordPress para el cliente se llama ahora ReportedIP Hive (antes reportedip-client). Nuevo repositorio en GitHub.com/reportedIP/ReportedIP Hive. El dominio de texto, el prefijo de clase y las claves de opciones se han trasladado a reportedip-hive.
  • Se ha añadido el conjunto de autenticación de dos factores (2FA) de Hive: TOTP (Authenticator Apps), códigos por correo electrónico, códigos por SMS, WebAuthn / Passkeys, Recovery Codes y Trusted Devices.
  • Se ha añadido un monitor de seguridad de 12 sensores en Hive (Block Escalation, anomalías geográficas, solidez de contraseñas, monitor REST, detector de escaneos, monitor de contraseñas de aplicaciones, monitor de WooCommerce, Hide Login, User Enumeration).
  • Se ha añadido el Setup Wizard de Hive (6 pasos) con selección de modo: «Local Shield» (solo sin conexión) frente a «Community Network» (sincronización con reportedip.de).

v2.1.0, noviembre de 2025

  • Se han añadido Endpoints de administración: POST /clear-address para la eliminación de registros de IP, POST /whitelist para la gestión de direcciones IP de confianza.
  • Se ha añadido GET /statistics Endpoint con estadísticas públicas de todo el servicio.
  • Se ha añadido un endpoint de estadísticas de Threat Categories y un endpoint de estadísticas de Blacklists con desgloses por banda de confianza.

v2.0.0, marzo de 2025

  • Se han añadido Endpoints públicos: /check-public, /search-public, /stats-public, /attack-map-data
  • Se ha añadido la integración de Honeypots con bonificación de confianza para los informadores automatizados de confianza
  • Se ha añadido el Endpoint de Bulk Check para usuarios de Professional+ (hasta 1 000 direcciones IP por solicitud)
  • Se ha añadido el Endpoint de Bulk Report para usuarios Enterprise con compatibilidad con el formato CSV
  • Se ha añadido un endpoint de datos de tendencias con análisis de series temporales
  • Se ha añadido un punto final de informes detallados por Endpoint para usuarios de Professional+
  • Se ha añadido la exportación de la Blacklist en formatos TXT, JSON y CSV
  • Se han añadido encabezados de Rate Limit: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
  • Se ha modificado el cálculo del Confidence Score para que ahora incluya Time Dampening con una vida media configurable
  • Modificado: agregación de informes con protección contra picos de tráfico (ventana de 5 minutos para informes duplicados)
  • Obsoleto /blacklist-detailed — redirige a /blacklist
  • En desuso /blacklist-combined — redirige a /blacklist?source=all
  • Obsoleto /blacklist-export/git — redirige a /blacklist?format=txt

v1.0.0, enero de 2025

  • Se ha añadido el Endpoint de comprobación de IP principal (/check)
  • Se ha añadido el endpoint de informe de IP (/report)
  • Se ha añadido el sistema de autenticación mediante API Key
  • Se ha añadido un endpoint de Blacklist básica (/blacklist)
  • Se han añadido 30 Threat Categories predefinidas con niveles de gravedad
  • Se han añadido los roles de usuario: Free User, Contributor, Professional y Enterprise (el rol «Business» se añadirá más adelante en la versión 2.3.0)
  • Se ha añadido un endpoint de verificación de API Keys (/verify-key)

Última actualización: · Gestionado por el equipo de reportedIP

Security Focused
GDPR Compliant
Made in Germany
Volver a Docs