#304 · Herramienta para desarrolladores

API Pagination Link Parser

Descompone una cabecera HTTP `Link` usada para paginación y muestra cada enlace con su relación `rel`, URL y parámetros adicionales. El parser admite varios enlaces separados por comas y valores entre comillas, por lo que resulta útil con respuestas que siguen el patrón habitual de RFC 8288. Además identifica relaciones comunes como `next`, `prev`, `first` y `last`. No solicita la URL ni sigue la paginación: trabaja con la cabecera cruda que pegues desde una respuesta HTTP.

Datos de entrada

Cabecera Link
Espacio publicitario

Cómo usar esta herramienta para desarrolladores

  1. Copia únicamente el valor de la cabecera `Link`, sin el prefijo `Link:` si no es necesario.
  2. Ejecuta el parser para separar los distintos enlaces.
  3. Revisa `rel` para localizar `next`, `prev`, `first` o `last`.
  4. Exporta los datos si quieres automatizar una comprobación posterior.

Qué hace esta herramienta para desarrolladores

Convierte una cabecera Link compleja en una lista legible de URLs, relaciones y parámetros de enlace.

El texto se separa por comas solo cuando la coma está fuera de comillas y del bloque ``. Cada segmento se analiza después como un enlace con parámetros `;`.

El parser no descarga páginas ni comprueba que las URLs sean accesibles. Tampoco interpreta políticas específicas de cada proveedor de API.

Ejemplo

Entrada

<https://api.example.com/items?page=2>; rel="next", <https://api.example.com/items?page=10>; rel="last", <https://api.example.com/items?page=1>; rel="first"

Salida esperada

Relación	URL	Parámetros
next	https://api.example.com/items?page=2	
last	https://api.example.com/items?page=10	
first	https://api.example.com/items?page=1

Casos de uso

  • Depurar paginación de APIs REST.
  • Extraer automáticamente la URL de la página siguiente desde una captura de cabeceras.
  • Revisar si una API expone first/last además de next/prev.
  • Documentar el comportamiento de paginación de un endpoint.

Consejos para obtener resultados fiables

  • Pega la cabecera exacta recibida del servidor para conservar parámetros.
  • No confundas `Link` con cabeceras personalizadas como `X-Next-Page`.
  • Comprueba si el proveedor usa cursores además de URLs.
  • No asumas que `last` existe en APIs con paginación infinita.
  • Si una URL contiene comas, mantenla dentro de `<...>` como exige el formato habitual.

Detalles del procesamiento

El analizador mantiene un pequeño estado para no dividir por comas dentro de comillas o del URI entre corchetes angulares. Después extrae parámetros clave/valor.

Algunas APIs usan formatos propietarios o cabeceras distintas. Esos casos deben adaptarse fuera de este parser.

Preguntas frecuentes

¿Puedo pegar la cabecera completa incluyendo `Link:`?

Es preferible pegar solo el valor. Si incluyes texto antes del primer `<`, puede impedir que el primer segmento se reconozca.

¿Qué relaciones de paginación reconoce el parser?

Extrae cualquier valor de `rel` y destaca de forma práctica relaciones comunes como `next`, `prev`, `first` y `last`.

¿El parser sigue automáticamente el enlace `next`?

No. No hace solicitudes de red; solo extrae la URL y los parámetros del encabezado.

¿Funciona si hay varias relaciones dentro de un mismo `rel`?

Sí. Un valor como `rel="next alternate"` se separa en relaciones individuales para el resumen.

¿Qué pasa si la API usa `X-Next-Page` en vez de `Link`?

Ese formato no corresponde a una cabecera Link y debe analizarse con una lógica específica del proveedor.

Módulos de la herramienta

MóduloComportamiento
Separador seguroEvita dividir por comas dentro de URL o comillas.
Parámetros LinkExtrae `rel` y otros atributos `; clave=valor`.
Resumen de relacionesIndica si existe `next` y cuántos rel distintos hay.

Explorar la categoría

Consulta más utilidades de API y GraphQL en el hub de la categoría.

Ver API y GraphQL