{"openapi":"3.1.0","info":{"title":"API abierta de Caset*","version":"1.0.0","description":"Casetes de Caset* (artículos narrados con el texto que sigue a la voz) para insertarlos en cualquier web o montar un reproductor propio. Solo lectura y sin clave. Solo están los casetes que se pueden insertar: los de FLOC* y los de creadores que son socios de Caset*."},"servers":[{"url":"https://app.caset.es/v1"}],"paths":{"/casetes":{"get":{"summary":"Casetes que se pueden insertar","parameters":[{"name":"url","in":"query","schema":{"type":"string"},"description":"Enlace del artículo original: devuelve su caset, si lo hay."}],"responses":{"200":{"description":"Lista","content":{"application/json":{"schema":{"type":"object","properties":{"casetes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"titulo":{"type":"string"},"autor":{"type":"string"},"fuente":{"type":"string"},"enlaceOriginal":{"type":["string","null"]},"idiomaOriginal":{"type":["string","null"]},"duracion":{"type":"number","description":"Segundos."},"capitulos":{"type":"array","items":{"type":"object","properties":{"titulo":{"type":"string"},"inicio":{"type":"number"}}}},"portada":{"type":["string","null"]},"avatar":{"type":["string","null"]},"creador":{"type":["object","null"]},"carcasa":{"type":"object","description":"Color, estilo y encuadre de la portada, como en la app."},"audio":{"type":"string","description":"MP3; admite rangos."},"idioma":{"type":"string","description":"Idioma de esta locución (es, en)."},"versiones":{"type":"array","description":"El mismo caset narrado en otros idiomas, con su título, capítulos, portada (la del documento en ese idioma, si la hay), audio y texto. En el reproductor insertado se elige con ?idioma=.","items":{"type":"object","properties":{"idioma":{"type":"string"},"titulo":{"type":"string"},"duracion":{"type":"number"},"capitulos":{"type":"array","items":{"type":"object","properties":{"titulo":{"type":"string"},"inicio":{"type":"number"}}}},"portada":{"type":["string","null"]},"audio":{"type":"string"},"texto":{"type":"string"}}}},"texto":{"type":"string","description":"JSON con el texto por frases y los tiempos de cada palabra."},"insertar":{"type":"object","properties":{"iframe":{"type":"string"},"html":{"type":"string"},"oembed":{"type":"string"}}}}}}}}}}}}}},"/casetes/{id}":{"get":{"summary":"Un caset","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"El caset","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"titulo":{"type":"string"},"autor":{"type":"string"},"fuente":{"type":"string"},"enlaceOriginal":{"type":["string","null"]},"idiomaOriginal":{"type":["string","null"]},"duracion":{"type":"number","description":"Segundos."},"capitulos":{"type":"array","items":{"type":"object","properties":{"titulo":{"type":"string"},"inicio":{"type":"number"}}}},"portada":{"type":["string","null"]},"avatar":{"type":["string","null"]},"creador":{"type":["object","null"]},"carcasa":{"type":"object","description":"Color, estilo y encuadre de la portada, como en la app."},"audio":{"type":"string","description":"MP3; admite rangos."},"idioma":{"type":"string","description":"Idioma de esta locución (es, en)."},"versiones":{"type":"array","description":"El mismo caset narrado en otros idiomas, con su título, capítulos, portada (la del documento en ese idioma, si la hay), audio y texto. En el reproductor insertado se elige con ?idioma=.","items":{"type":"object","properties":{"idioma":{"type":"string"},"titulo":{"type":"string"},"duracion":{"type":"number"},"capitulos":{"type":"array","items":{"type":"object","properties":{"titulo":{"type":"string"},"inicio":{"type":"number"}}}},"portada":{"type":["string","null"]},"audio":{"type":"string"},"texto":{"type":"string"}}}},"texto":{"type":"string","description":"JSON con el texto por frases y los tiempos de cada palabra."},"insertar":{"type":"object","properties":{"iframe":{"type":"string"},"html":{"type":"string"},"oembed":{"type":"string"}}}}}}}},"404":{"description":"No existe o no se puede insertar"}}}},"/creadores/{slug}":{"get":{"summary":"Los casetes de un creador","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Creador y casetes"}}}},"/audio/{id}.mp3":{"get":{"summary":"Audio del caset","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"audio/mpeg"},"206":{"description":"Rango"}}}},"/transcripts/{id}.json":{"get":{"summary":"Texto con tiempos por palabra","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"JSON"}}}},"/oembed":{"get":{"summary":"oEmbed","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"},"description":"https://caset.es/e/<id>"},{"name":"maxwidth","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"oEmbed rich"}}}}}}