Suscribirse al feed Atom

Objetivo

Suscribirse al changelog de MexCep via un feed Atom 1.0 estándar. Funciona con cualquier lector RSS moderno (Feedly, NetNewsWire, Inoreader, Thunderbird, Apple Mail) y con herramientas de automatización que hacen polling de feeds para workflows disparados por releases (Zapier, n8n, GitHub Actions cron).

Prerrequisitos

Ninguno para entradas de audiencia public — el feed las sirve a clientes anónimos. Para recibir también entradas de audiencia admin, el lector debe enviar la cookie app_token (la mayoría no puede; considera hacer polling del endpoint JSON con auth custom en su lugar).

Pasos

1. Agregar la URL del feed a tu lector

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

La mayoría de lectores auto-detectan el feed y piden confirmación. Para verificar manualmente:

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

La respuesta es application/atom+xml. Valida en https://validator.w3.org/feed/.

2. Estructura de ejemplo

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
  <id>https://api.example.com/v1/public/changelog/feed.atom</id>
  <title>MexCep Changelog</title>
  <updated>2026-05-28T11:00:00Z</updated>
  <link rel="self" href="https://api.example.com/v1/public/changelog/feed.atom" />
  <link rel="alternate" href="https://docs.example.com/es/changelog" />
  <author><name>MexCep</name></author>
  <entry>
    <id>https://docs.example.com/changelog/v1.49.6/url-convention</id>
    <title>Convención de URL formalizada + 13 paths movidos</title>
    <updated>2026-05-28T10:30:00Z</updated>
    <published>2026-05-28T10:30:00Z</published>
    <link rel="alternate" href="https://docs.example.com/changelog/v1.49.6/url-convention" />
    <summary>...</summary>
    <category term="breaking" />
    <category term="audience:public" />
  </entry>
</feed>

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.atom?lang=es&limit=5'

El servidor aplica la audiencia contra tu auth. Un request anónimo no puede escalar a audience=admin y recibir entradas admin.

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 del feed. Usa el `ETag` del endpoint JSON en su lugar.

Notas

El feed es append-only — las entradas nunca desaparecen una vez publicadas, así que un lector que ya vio una entrada no la mostrará de nuevo.
El timestamp <updated> de cada entrada refleja el published_at del release, no la última edición del body.
¿Necesitas JSON? Ver Suscribirse al feed JSON.
ADR-0090 (Convención de URL) explica el movimiento al namespace /v1/public/*.

Nuevo en v1.49.6 — ver ADR-0090.