Endpoint de la API REST

GET /v1/proofreading

Hasta 100 sugerencias de revisión de texto visibles en ese momento, procedentes de los artículos comprobados más recientemente de un tracker.

Solicitud

GET https://api.nowmetrix.com/v1/proofreading?site=TRACKER_ID&limit=50

Utilice este endpoint para obtener las sugerencias de revisión de texto actuales más recientes de un tracker autorizado. Se excluyen los resultados marcados como corregidos o cubiertos por una regla activa para ignorarlos.

Autenticación

Requiere una clave de API en la cabecera Authorization: Bearer nm_YOUR_KEY. La clave debe tener acceso al ID del tracker solicitado.

Parámetros de consulta

Nombre Tipo Obligatorio Descripción
site string obligatorio ID de seguimiento de NowMetrix. La clave de API debe tener acceso a este tracker. No envíe el dominio de la publicación.
limit integer opcional Número máximo de sugerencias. El valor predeterminado es 50 y el límite máximo es 100.

Ejemplo con cURL

curl -H "Authorization: Bearer nm_YOUR_KEY" \
  "https://api.nowmetrix.com/v1/proofreading?site=TRACKER_ID&limit=50"

Ejemplo de respuesta

{
  "site": "TRACKER_ID",
  "updated_at": "2026-01-15T09:30:00+00:00",
  "limit": 50,
  "count": 1,
  "issues": [
    {
      "id": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
      "checked_at": "2026-01-15T09:25:00+00:00",
      "article": {
        "title": "Example article",
        "url": "https://www.example.com/news/example-article"
      },
      "language": {
        "code": "en",
        "name": "English"
      },
      "category": {
        "code": "consistency",
        "label": "Article inconsistency"
      },
      "location": {
        "code": "body",
        "label": "Body"
      },
      "original": "Northwind Lab",
      "original_occurrence": 1,
      "correction": "Northwind Labs",
      "context": "The announcement was published by Northwind Lab on Monday.",
      "explanation": "The organization is named Northwind Labs elsewhere in the same article.",
      "confidence": "high"
    }
  ]
}

Campos de la respuesta

Campo Tipo Descripción
site string ID de seguimiento utilizado para la solicitud.
updated_at string Marca de tiempo UTC de la generación de la carga útil.
limit integer Límite efectivo de resultados después de la validación y la aplicación del límite máximo.
count integer Número de sugerencias visibles devueltas.
issues[] array<object> Sugerencias visibles ordenadas por checked_at en orden descendente.
issues[].id string Identificador estable y opaco de esta aparición de la sugerencia.
issues[].checked_at string Marca de tiempo UTC de la comprobación del artículo que generó la sugerencia actual.
issues[].article object Título y URL completa del artículo. No se exponen los ID internos del artículo.
issues[].language object Código del idioma detectado y nombre mostrado.
issues[].category object Código de categoría legible por máquinas y etiqueta localizada. El código consistency identifica contradicciones internas del artículo en nombres o datos objetivos, como cifras, fechas, horas, edades, ubicaciones y cargos.
issues[].location object Código de la sección del artículo y etiqueta localizada.
issues[].original string Texto original identificado mediante la revisión de texto.
issues[].original_occurrence integer|null Aparición, empezando por 1, del texto original dentro del contexto. En los resultados antiguos puede ser null cuando no es posible localizar inequívocamente un texto repetido.
issues[].correction string Corrección sugerida.
issues[].context string Contexto del artículo normalizado y limitado en longitud.
issues[].explanation string Explicación de la sugerencia.
issues[].confidence string Nivel de confianza aceptado por el flujo de revisión de texto.

Actualización y caché

Las respuestas se almacenan en una microcaché por tracker y límite durante 30 segundos. La respuesta incluye X-NowMetrix-Microcache con el valor HIT o MISS. checked_at indica la hora de comprobación del artículo; el endpoint no es un historial acumulativo de las primeras detecciones.

Errores

HTTP Código Descripción
400 site_required Falta el parámetro obligatorio site.
401 missing_token Falta la cabecera Authorization.
401 invalid_token El token no es válido o se ha revocado.
403 site_not_authorized La clave de API no tiene acceso a este tracker.
429 rate_limit_exceeded Se ha superado el límite de solicitudes.
503 redis_unavailable El backend en tiempo real no está disponible temporalmente.
409 proofreading_not_enabled La revisión de texto no está activada para el tracker solicitado.
500 encoding_failed No se ha podido codificar la respuesta.
503 database_unavailable La base de datos de revisión de texto no está disponible temporalmente.
503 proofreading_unavailable No se ha podido generar el flujo de revisión de texto. 
{
  "error": {
    "code": "proofreading_not_enabled",
    "message": "Proofreading is not enabled for this tracker."
  }
}