Desarrolladores

Empezar

Todas las rutas viven bajo /api/v1 y se autentican con una cabecera Authorization: Bearer. Las respuestas son JSON UTF-8 y el CORS está abierto en GET: una llamada desde un navegador funciona.

Especificación completa (OpenAPI 3.1): /api/v1/openapi.json

Obtener una clave

No hay alta automática en esta primera versión: escríbenos describiendo el uso previsto, el volumen esperado y dónde aparecerá la atribución. Creamos la clave a mano y te la enviamos.

La clave se entrega UNA sola vez: solo guardamos una huella SHA-256, así que no podemos volver a leértela. Si se pierde o se expone, se revoca y se sustituye — una clave revocada lo está definitivamente.

Escríbenos: [email protected]

Puntos de entrada

Parámetros

• lang — código ISO 639-1 (fr, en, zh…). El contenido se sirve traducido si existe la traducción, si no en inglés, si no en el idioma original.
• topic — slug de sección (ver /topics).
• limit — de 1 a 50 (20 por defecto).
• cursor — el nextCursor de la respuesta anterior. Opaco: no lo interpretes, su codificación cambiará.

Ejemplos

# las últimas noticias
curl -H "Authorization: Bearer $AUBE_KEY" \
  "https://aube.news/api/v1/stories?lang=es&limit=5"

# un artículo, en inglés
curl -H "Authorization: Bearer $AUBE_KEY" \
  "https://aube.news/api/v1/stories/mon-slug?lang=en"

# página siguiente (cursor opaco)
curl -H "Authorization: Bearer $AUBE_KEY" \
  "https://aube.news/api/v1/stories?limit=5&cursor=$CURSOR"

{
  "stories": [ /* … */ ],
  "nextCursor": "bzE6NQ",
  "lang": "en",
  "attribution": { "name": "Aube", "url": "https://aube.news" }
}

Cuotas y errores

Cada clave lleva una cuota diaria que se pone a cero a medianoche. Las respuestas llevan X-RateLimit-Limit y X-RateLimit-Remaining; superada la cuota, la API responde 429 con Retry-After (en segundos) — y la llamada rechazada no se descuenta.

• 400 — parámetro no válido (limit fuera de rango, cursor ilegible…).
• 401 — clave ausente, desconocida o revocada.
• 404 — noticia desconocida o no publicada.
• 429 — cuota diaria alcanzada.
• 500 — error por nuestra parte: reinténtalo y después avísanos.

Atribución

Cada respuesta lleva un objeto attribution. Toda reutilización pública debe citar «Aube» y apuntar a la página de origen (el campo url de la noticia). No es coquetería: nuestros artículos remiten a su vez a sus fuentes primarias, y esa cadena de citas es lo que distingue una información de un rumor.

En la práctica:

• cita «Aube» junto al contenido reutilizado, con un enlace clicable a story.url;
• para las series de /metrics, cita TAMBIÉN la fuente primaria facilitada (source.name / source.url);
• no republiques el cuerpo completo (bodyMd) de un artículo: reutiliza el TL;DR o un extracto, y remite a Aube;
• conserva la etiqueta «contenido patrocinado» (isSponsored) cuando esté presente — sin excepción.

Widget insertable

La buena noticia del día, en 180 píxeles de alto, sin cookies ni scripts de terceros. Pega este iframe donde quieras:

<iframe src="https://aube.news/widget?lang=es&theme=light"
        width="100%" height="180" frameborder="0"
        title="Aube — la buena noticia del día"
        loading="lazy"></iframe>

Parámetros: lang=fr|en|es|pt|de|it y theme=light|dark. El widget ya lleva su atribución y abre el artículo en Aube en una pestaña nueva.

Vista previa