{"openapi":"3.1.0","info":{"title":"Ministerios Online — API pública","version":"1.0.0","description":"Endpoints públicos de solo lectura de ministeriosonline.com (contenido bíblico y metadatos de transmisión). Plataforma de streaming para iglesias y ministerios hispanos. No incluye rutas que escriben datos, consumen cuota de terceros o requieren autenticación — ver /llms.txt para el resto del sitio.","contact":{"name":"Ministerios Online","email":"info@ministeriosonline.com","url":"https://ministeriosonline.com/contacto"},"license":{"name":"Uso permitido según los Términos de Servicio","url":"https://ministeriosonline.com/terminos"}},"servers":[{"url":"https://ministeriosonline.com","description":"Producción"}],"tags":[{"name":"biblia","description":"Contenido bíblico público (Reina-Valera 1909)"},{"name":"streaming","description":"Metadatos en vivo de canales de radio/TV"}],"paths":{"/api/bible/daily":{"get":{"operationId":"getBibleDaily","summary":"Versículo del día","description":"Devuelve un versículo distinto cada día del año (Reina-Valera 1909), calculado por día-del-año en hora AST (UTC-4). El mismo versículo se repite cada año en la misma fecha.","tags":["biblia"],"parameters":[],"responses":{"200":{"description":"Versículo del día","content":{"application/json":{"schema":{"type":"object","required":["ref","text","bookName","chapter","verse","url","date"],"properties":{"ref":{"type":"string"},"text":{"type":"string"},"bookName":{"type":"string"},"chapter":{"type":"integer"},"verse":{"type":"integer"},"url":{"type":"string","format":"uri"},"date":{"type":"string","format":"date"}}},"example":{"ref":"1 Tesalonicenses 5:18","text":"Dad gracias en todo; porque esta es la voluntad de Dios para con vosotros en Cristo Jesús.","bookName":"1 Tesalonicenses","chapter":5,"verse":18,"url":"https://ministeriosonline.com/biblia/1%20Tesalonicenses/5","date":"2026-08-17"}}}},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/bible/daily-rss":{"get":{"operationId":"getBibleDailyRss","summary":"Versículo del día en RSS/XML","description":"Igual que /api/bible/daily pero en formato RSS 2.0, pensado para redes sociales automatizadas (incluye una imagen de versículo lista para publicar).","tags":["biblia"],"parameters":[],"responses":{"200":{"description":"Feed RSS con el versículo del día","content":{"application/xml":{"schema":{"type":"string"},"example":"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<rss version=\"2.0\" xmlns:media=\"http://search.yahoo.com/mrss/\">\n  <channel>\n    <title>Versiculo del Dia - Ministerios Online</title>\n    <link>https://ministeriosonline.com/biblia</link>\n    <description>Versiculo diario Reina-Valera 1909 para redes sociales</description>\n    <language>es</language>\n    <item>\n      <title>Salmos 139:14 — Versiculo del Dia</title>\n      <guid isPermaLink=\"false\">versiculo-2026-08-27</guid>\n      <pubDate>Thu, 27 Aug 2026 18:00:36 GMT</pubDate>\n      <enclosure url=\"https://xmvnbkimclvvtemhaufo.supabase.co/storage/v1/object/public/media/versiculo-del-dia.png\" length=\"0\" type=\"image/png\"/>\n      <media:content url=\"https://xmvnbkimclvvtemhaufo.supabase.co/storage/v1/object/public/media/versiculo-del-dia.png\" medium=\"image\"/>\n      <description><![CDATA[...]]></description>\n    </item>\n  </channel>\n</rss>"}}},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/bible":{"get":{"operationId":"getBibleChapter","summary":"Texto de un capítulo bíblico","description":"Devuelve todos los versículos de un capítulo (Reina-Valera 1909).","tags":["biblia"],"parameters":[{"name":"book","in":"query","required":true,"schema":{"type":"string"},"description":"Código de libro de 3 letras (p. ej. JHN, GEN, PSA). No distingue mayúsculas/minúsculas.","example":"JHN"},{"name":"chapter","in":"query","required":true,"schema":{"type":"integer","minimum":1},"example":3}],"responses":{"200":{"description":"Versículos del capítulo solicitado","content":{"application/json":{"schema":{"type":"object","required":["verses"],"properties":{"verses":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"text":{"type":"string"}}}}}},"example":{"verses":[{"number":1,"text":"Y había un hombre de los Fariseos que se llamaba Nicodemo, príncipe de los Judíos."},{"number":2,"text":"Este vino a Jesús de noche, y díjole: Rabbí, sabemos que has venido de Dios por maestro; porque nadie puede hacer estas señales que tú haces, si no fuere Dios con él."}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/bible/search":{"get":{"operationId":"searchBible","summary":"Búsqueda de texto en la Biblia","description":"Búsqueda de subcadena (sin acentos ni mayúsculas) sobre los ~31.000 versículos de la Reina-Valera 1909. Con menos de 3 caracteres en \"q\", responde 200 con hits vacíos y un campo error informativo — no es un error HTTP.","tags":["biblia"],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":3},"example":"amor"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"maximum":100},"example":2}],"responses":{"200":{"description":"Resultados de la búsqueda","content":{"application/json":{"schema":{"type":"object","required":["query","total","hits"],"properties":{"query":{"type":"string"},"total":{"type":"integer"},"hits":{"type":"array","items":{"type":"object","properties":{"book":{"type":"string"},"bookId":{"type":"string"},"chapter":{"type":"integer"},"verse":{"type":"integer"},"text":{"type":"string"}}}},"limited":{"type":"boolean"}}},"example":{"query":"amor","total":355,"hits":[{"book":"Génesis","bookId":"GEN","chapter":3,"verse":17,"text":"Y al hombre dijo: Por cuanto obedeciste a la voz de tu mujer, y comiste del árbol de que te mandé diciendo, No comerás de él; maldita será la tierra por amor de ti; con dolor comerás de ella todos los días de tu vida;"},{"book":"Génesis","bookId":"GEN","chapter":10,"verse":16,"text":"Y al Jebuseo, y al Amorrheo, y al Gergeseo,"}],"limited":true}}}},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/stream-meta":{"get":{"operationId":"getStreamMeta","summary":"Metadata en vivo de un canal","description":"Devuelve la canción/programa actual y el número de oyentes de un canal, consultando MediaCP por su service ID interno. Es fail-open: si MediaCP no responde o el servicio no existe, devuelve 200 con nowPlaying/listeners en null en vez de un error — no hay un caso documentado de 500.","tags":["streaming"],"parameters":[{"name":"serviceId","in":"query","required":true,"schema":{"type":"string"},"description":"ID interno del servicio en MediaCP (visible en el dashboard del operador de canal, no en este sitio público).","example":"1"}],"responses":{"200":{"description":"Metadata del canal (o nulls si MediaCP no respondió)","content":{"application/json":{"schema":{"type":"object","properties":{"nowPlaying":{"type":["string","null"]},"listeners":{"type":["integer","null"]}}},"example":{"nowPlaying":null,"listeners":null}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}}},"components":{"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","status"],"properties":{"code":{"type":"string","example":"not_found"},"message":{"type":"string"},"hint":{"type":"string"},"status":{"type":"integer"},"docs":{"type":"string","format":"uri"},"request_id":{"type":"string"}}}}}},"responses":{"NotFound":{"description":"Recurso no encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"BadRequest":{"description":"Parámetros inválidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"ServerError":{"description":"Error interno","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}