{"openapi":"3.1.0","info":{"title":"El Autómata API","version":"1.0.0","description":"Las noticias de El Autómata (un diario redactado automáticamente, y al día en continuo, a partir de la prensa y la radio españolas): portadas, noticias, archivo, boletines de audio y preguntas. Sin clave: límites por IP. Con clave (Authorization: Bearer hk_…): límites más altos. Cada noticia debe reproducirse con sus fuentes enlazadas."},"servers":[{"url":"https://elautomata.es"}],"components":{"securitySchemes":{"key":{"type":"http","scheme":"bearer","description":"Clave de API hk_… (opcional salvo en webhooks)"}}},"security":[{},{"key":[]}],"paths":{"/v1/editions":{"get":{"summary":"Ediciones","responses":{"200":{"description":"Lista de ediciones con sus fuentes y horario","content":{"application/json":{}}}}}},"/v1/editions/{ed}":{"get":{"summary":"Una edición","parameters":[{"name":"ed","in":"path","required":true,"schema":{"type":"string","enum":["nacional","vega-baja","benidorm","espana","internacional","economia","sociedad","tecnologia","cultura","deportes","padel","bicimonte"]}}],"responses":{"200":{"description":"Edición","content":{"application/json":{}}}}}},"/v1/editions/{ed}/front":{"get":{"summary":"Portada","parameters":[{"name":"ed","in":"path","required":true,"schema":{"type":"string","enum":["nacional","vega-baja","benidorm","espana","internacional","economia","sociedad","tecnologia","cultura","deportes","padel","bicimonte"]}},{"name":"at","in":"query","required":false,"schema":{"type":"string"},"description":"Fecha ISO o id de edición (2026-10-19T1130) para una portada pasada"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","markdown"]},"description":"json (por defecto) o markdown"}],"responses":{"200":{"description":"Portada: noticias en orden, «En antena», equilibrio y estado de las fuentes","content":{"application/json":{}}}}}},"/v1/editions/{ed}/history":{"get":{"summary":"Hemeroteca","parameters":[{"name":"ed","in":"path","required":true,"schema":{"type":"string","enum":["nacional","vega-baja","benidorm","espana","internacional","economia","sociedad","tecnologia","cultura","deportes","padel","bicimonte"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"Hasta 2000"}],"responses":{"200":{"description":"Ediciones publicadas, de la más nueva a la más antigua","content":{"application/json":{}}}}}},"/v1/editions/{ed}/podcast":{"get":{"summary":"Boletín «Las noticias en 5 minutos»","parameters":[{"name":"ed","in":"path","required":true,"schema":{"type":"string","enum":["nacional","vega-baja","benidorm","espana","internacional","economia","sociedad","tecnologia","cultura","deportes","padel","bicimonte"]}}],"responses":{"200":{"description":"MP3, duración y capítulos","content":{"application/json":{}}}}}},"/v1/editions/{ed}/stories/{id}":{"get":{"summary":"Noticia","parameters":[{"name":"ed","in":"path","required":true,"schema":{"type":"string","enum":["nacional","vega-baja","benidorm","espana","internacional","economia","sociedad","tecnologia","cultura","deportes","padel","bicimonte"]}},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Story id (the slug in its URL)"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","markdown","html"]},"description":"json, markdown o html"}],"responses":{"200":{"description":"La noticia completa con fuentes, enfoques, radio y aviso de autoría automática","content":{"application/json":{}}}}}},"/v1/editions/{ed}/stories/{id}/versions":{"get":{"summary":"Versiones de una noticia","parameters":[{"name":"ed","in":"path","required":true,"schema":{"type":"string","enum":["nacional","vega-baja","benidorm","espana","internacional","economia","sociedad","tecnologia","cultura","deportes","padel","bicimonte"]}},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Story id (the slug in its URL)"}],"responses":{"200":{"description":"Cada reescritura","content":{"application/json":{}}}}}},"/v1/stories":{"get":{"summary":"Buscar en el archivo / feed","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Texto completo en español; \"frase exacta\"; -excluir"},{"name":"edition","in":"query","required":false,"schema":{"type":"string"},"description":"Una o varias, separadas por comas"},{"name":"section","in":"query","required":false,"schema":{"type":"string"},"description":"Sección"},{"name":"outlet","in":"query","required":false,"schema":{"type":"string"},"description":"Solo noticias que citan a este medio (p. ej. El País)"},{"name":"since","in":"query","required":false,"schema":{"type":"string"},"description":"Actualizadas después de (ISO)"},{"name":"from","in":"query","required":false,"schema":{"type":"string"},"description":"Publicadas desde (ISO)"},{"name":"to","in":"query","required":false,"schema":{"type":"string"},"description":"Publicadas hasta (ISO)"},{"name":"order","in":"query","required":false,"schema":{"enum":["relevance","recent"]},"description":"relevance o recent"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"Hasta 100"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer"},"description":"Paginación"}],"responses":{"200":{"description":"{ total, results }","content":{"application/json":{}}}}}},"/v1/ask":{"post":{"summary":"Pregúntale al Autómata","description":"Responde una pregunta sobre la actualidad a partir del archivo, los artículos de las fuentes y la radio. Respuesta en Markdown con enlaces y lista de citas. Con stream: true, un AI SDK UI message stream (SSE).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["question"],"properties":{"question":{"type":"string","maxLength":1000},"edition":{"type":"string","enum":["nacional","vega-baja","benidorm","espana","internacional","economia","sociedad","tecnologia","cultura","deportes","padel","bicimonte"]},"story":{"type":"string","description":"\"edition/id\": preguntas sobre una noticia"},"conversation_id":{"type":"string","description":"Para seguir una conversación"},"stream":{"type":"boolean"}}}}}},"responses":{"200":{"description":"{ conversation_id, answer, citations, model, cost_usd, ms }","content":{"application/json":{}}}}}},"/v1/webhooks":{"get":{"summary":"Tus webhooks","security":[{"key":[]}],"responses":{"200":{"description":"Lista","content":{"application/json":{}}}}},"post":{"summary":"Crear webhook","security":[{"key":[]}],"description":"Eventos: edition.published, story.breaking. Cada POST lleva x-heraldo-signature: sha256=HMAC-SHA256(cuerpo, secret). El secret solo se muestra al crearlo.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"events":{"type":"array","items":{"enum":["edition.published","story.breaking"]}},"editions":{"type":"array","items":{"type":"string","enum":["nacional","vega-baja","benidorm","espana","internacional","economia","sociedad","tecnologia","cultura","deportes","padel","bicimonte"]}}}}}}},"responses":{"201":{"description":"{ id, url, events, editions, secret }"}}}},"/v1/webhooks/{id}":{"delete":{"summary":"Borrar webhook","security":[{"key":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"wh_…"}],"responses":{"200":{"description":"Borrado","content":{"application/json":{}}}}}}}}