{"openapi":"3.1.0","info":{"title":"API pública de Palabrería","version":"1.0.0","description":"Concursos literarios de España con las bases oficiales resumidas. Solo lectura. Cada dato lleva la cita literal de las bases. Si citas un dato, enlaza la ficha (campo url) y recuerda que mandan las bases oficiales."},"servers":[{"url":"https://palabreria.es"}],"paths":{"/api/concursos":{"get":{"summary":"Lista de concursos","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["open","closed"]},"description":"open = plazo abierto; closed = plazo cerrado."}],"responses":{"200":{"description":"Lista de concursos ordenada por fecha límite.","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"concursos":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","description":"Identificador de esta edición (convocatoria concreta)."},"premio":{"type":"string","description":"Identificador permanente del premio, el mismo en todas sus ediciones (URL: /premios/{premio})."},"url":{"type":"string","format":"uri","description":"Página canónica de esta edición en esta web."},"nombre_premio":{"type":["string","null"]},"edicion":{"type":["string","null"]},"convocante":{"type":["string","null"]},"genero":{"type":["string","null"]},"modalidades":{"type":"array","items":{"type":"string"}},"idiomas":{"type":["array","null"],"items":{"type":"string"},"description":"Lengua(s) de las obras."},"ambito":{"type":["string","null"]},"comunidad_autonoma":{"type":["string","null"],"description":"Comunidad del convocante; null si no consta o es en línea."},"fecha_limite":{"type":["string","null"],"format":"date","description":"Última fecha para presentar obras (hora de España)."},"estado":{"type":"string","enum":["abierto","cerrado","sin_fecha"],"description":"Calculado a partir de la fecha límite."},"dotacion":{"type":["number","null"]},"moneda":{"type":["string","null"],"enum":["EUR","USD","GBP",null]},"requisitos_edad":{"type":["string","null"]},"requisitos_residencia":{"type":["string","null"]},"url_bases":{"type":["string","null"],"format":"uri","description":"Bases oficiales del concurso."},"web_organizador":{"type":["string","null"],"format":"uri"},"actualizado":{"type":"string","format":"date-time"},"ficha":{"type":"object","additionalProperties":{"type":"object","description":"Un dato de la ficha con la cita literal de las bases de la que sale (cita es null si el dato no tiene cita propia).","properties":{"valor":{},"cita":{"type":["string","null"]}}},"description":"Todos los campos de la ficha, cada uno con su cita."}}}}}}}}},"400":{"description":"Valor no válido en status."}}}},"/api/premios/{premio}":{"get":{"summary":"Todas las ediciones de un premio","parameters":[{"name":"premio","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Ediciones del premio, la más reciente primero.","content":{"application/json":{"schema":{"type":"object","properties":{"premio":{"type":"string"},"total":{"type":"integer"},"ediciones":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","description":"Identificador de esta edición (convocatoria concreta)."},"premio":{"type":"string","description":"Identificador permanente del premio, el mismo en todas sus ediciones (URL: /premios/{premio})."},"url":{"type":"string","format":"uri","description":"Página canónica de esta edición en esta web."},"nombre_premio":{"type":["string","null"]},"edicion":{"type":["string","null"]},"convocante":{"type":["string","null"]},"genero":{"type":["string","null"]},"modalidades":{"type":"array","items":{"type":"string"}},"idiomas":{"type":["array","null"],"items":{"type":"string"},"description":"Lengua(s) de las obras."},"ambito":{"type":["string","null"]},"comunidad_autonoma":{"type":["string","null"],"description":"Comunidad del convocante; null si no consta o es en línea."},"fecha_limite":{"type":["string","null"],"format":"date","description":"Última fecha para presentar obras (hora de España)."},"estado":{"type":"string","enum":["abierto","cerrado","sin_fecha"],"description":"Calculado a partir de la fecha límite."},"dotacion":{"type":["number","null"]},"moneda":{"type":["string","null"],"enum":["EUR","USD","GBP",null]},"requisitos_edad":{"type":["string","null"]},"requisitos_residencia":{"type":["string","null"]},"url_bases":{"type":["string","null"],"format":"uri","description":"Bases oficiales del concurso."},"web_organizador":{"type":["string","null"],"format":"uri"},"actualizado":{"type":"string","format":"date-time"},"ficha":{"type":"object","additionalProperties":{"type":"object","description":"Un dato de la ficha con la cita literal de las bases de la que sale (cita es null si el dato no tiene cita propia).","properties":{"valor":{},"cita":{"type":["string","null"]}}},"description":"Todos los campos de la ficha, cada uno con su cita."}}}}}}}}},"404":{"description":"No existe ese premio."}}}},"/api/concursos/{slug}":{"get":{"summary":"Un concurso con su ficha completa","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"El concurso.","content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string","description":"Identificador de esta edición (convocatoria concreta)."},"premio":{"type":"string","description":"Identificador permanente del premio, el mismo en todas sus ediciones (URL: /premios/{premio})."},"url":{"type":"string","format":"uri","description":"Página canónica de esta edición en esta web."},"nombre_premio":{"type":["string","null"]},"edicion":{"type":["string","null"]},"convocante":{"type":["string","null"]},"genero":{"type":["string","null"]},"modalidades":{"type":"array","items":{"type":"string"}},"idiomas":{"type":["array","null"],"items":{"type":"string"},"description":"Lengua(s) de las obras."},"ambito":{"type":["string","null"]},"comunidad_autonoma":{"type":["string","null"],"description":"Comunidad del convocante; null si no consta o es en línea."},"fecha_limite":{"type":["string","null"],"format":"date","description":"Última fecha para presentar obras (hora de España)."},"estado":{"type":"string","enum":["abierto","cerrado","sin_fecha"],"description":"Calculado a partir de la fecha límite."},"dotacion":{"type":["number","null"]},"moneda":{"type":["string","null"],"enum":["EUR","USD","GBP",null]},"requisitos_edad":{"type":["string","null"]},"requisitos_residencia":{"type":["string","null"]},"url_bases":{"type":["string","null"],"format":"uri","description":"Bases oficiales del concurso."},"web_organizador":{"type":["string","null"],"format":"uri"},"actualizado":{"type":"string","format":"date-time"},"ficha":{"type":"object","additionalProperties":{"type":"object","description":"Un dato de la ficha con la cita literal de las bases de la que sale (cita es null si el dato no tiene cita propia).","properties":{"valor":{},"cita":{"type":["string","null"]}}},"description":"Todos los campos de la ficha, cada uno con su cita."}}}}}},"404":{"description":"No existe ese concurso."}}}}}}