Suscribirse al feed JSON

Objetivo

Consumir el changelog de MexCep via JSON Feed 1.1, la alternativa moderna y ligera a RSS/Atom. Compatible con NetNewsWire, Reeder 5+ y con cualquier script custom de polling que prefiera JSON sobre XML.

Prerrequisitos

Ninguno para entradas public. Las entradas de audiencia admin requieren sesión cookie con permiso docs:read.

Pasos

1. Agregar la URL del feed a tu lector

https://api.example.com/v1/public/changelog/feed.json

Verifica manualmente:

curl 'https://api.example.com/v1/public/changelog/feed.json'

La respuesta es application/feed+json. Valida en https://validator.jsonfeed.org/.

2. Estructura de ejemplo

{
  "version": "https://jsonfeed.org/version/1.1",
  "title": "MexCep Changelog",
  "home_page_url": "https://docs.example.com/es/changelog",
  "feed_url": "https://api.example.com/v1/public/changelog/feed.json",
  "language": "es",
  "authors": [{ "name": "MexCep" }],
  "items": [
    {
      "id": "https://docs.example.com/changelog/v1.49.6/url-convention",
      "url": "https://docs.example.com/changelog/v1.49.6/url-convention",
      "title": "Convención de URL formalizada + 13 paths movidos",
      "summary": "Formaliza la convención de namespace de 4 prefijos y mueve 11 paths.",
      "date_published": "2026-05-28T10:30:00Z",
      "tags": ["breaking", "audience:public", "api", "routes"]
    }
  ]
}

3. Filtrar el feed

Parámetro	Default	Descripción
`audience`	auto-detect	`public` (anon) o `admin` (cookie + `docs:read`).
`lang`	`en`	Idioma del feed. `en` o `es`.
`limit`	`50`	Entradas por feed (1–100).

# Español, las 5 entradas más recientes
curl 'https://api.example.com/v1/public/changelog/feed.json?lang=es&limit=5'

Errores

Estado	Código	Causa
400	`invalid_lang` / `invalid_audience` / `invalid_limit`	Valor de param fuera del enum/rango.
401	`unauthorized`	Pediste `audience=admin` sin auth por cookie.
403	`forbidden`	Cookie presente pero sin `docs:read`.
429	`rate_limited`	Polling muy agresivo.

Notas

El array items[].tags lleva categoría + flags de audiencia para que scripts custom puedan filtrar client-side sin re-fetching.
Para consumidores estilo RSS/Atom, ver Suscribirse al feed Atom.
ADR-0090 (Convención de URL) explica el movimiento al namespace /v1/public/*.

Nuevo en v1.49.6 — ver ADR-0090.