API · v1
Inserta un caset en tu web
Un caset es un artículo narrado en formato podcast, con el texto que sigue a la voz. Con esta API puedes ponerlo en cualquier web con una línea o montar tu propio reproductor con sus datos. Es abierta: solo lectura, sin clave y con CORS abierto.
Así se ve: el caset de «Diseñando en Charms», de Javi · FLOC*, insertado en esta página con la línea de abajo.
1. Con una línea
Pega esto donde quieras el caset. Crea el reproductor y ajusta su alto solo.
<script src="https://caset.es/insertar.js" data-caset="charms" async></script>
Con data-texto="1" enseña también el texto que sigue a la voz. Suena en el idioma de tu página (el lang de su <html>) si el caset lo tiene; data-idioma="en" lo fuerza (mira «Idiomas»).
A la medida de tu web
El caset se puede insertar entero, solo la cinta o como una barra mini, y adaptarlo al diseño de la web donde va: tema, fondo, colores, tipografía y esquinas. Elige aquí, mira cómo queda y copia la línea.
| Opción | Qué hace |
|---|---|
data-vista | completo (de serie), cinta (solo la cinta: se toca para escuchar, con sus bobinas y su idioma) o mini (una barra limpia: la cinta pequeña, el título, el play y el progreso). |
data-tema | oscuro (de serie) o claro. |
data-fondo | Un color (#111111) o transparente. La cinta sola va siempre sin fondo, sobre el de tu web. |
data-tinta | El color del texto; los grises y las líneas salen de él. |
data-acento | El color del botón de play y de la barra de progreso de la mini. |
data-idioma | De serie, el de tu página (<html lang="en">): un post en inglés suena en inglés y uno en español, en español, si el caset tiene ese idioma. Con data-idioma lo fijas. |
data-fuente | Geist (de serie) o cualquier familia de Google Fonts, por su nombre. |
data-radio | El radio de las esquinas de la mini, en píxeles (0 a 40). |
data-texto | 1 para enseñar el texto que sigue a la voz (en la vista completa). |
En el iframe son las mismas opciones, sin data-: https://caset.es/e/charms?vista=mini&fondo=111111&acento=00ff00 (los colores, con o sin #).
2. Con un iframe
<iframe src="https://caset.es/e/charms" title="Caset*" width="100%" height="560"
style="border:0;border-radius:16px;max-width:640px" allow="autoplay" loading="lazy"></iframe>
Añade ?texto=1 a la dirección para el texto y ?idioma=en para otro idioma (juntos: ?texto=1&idioma=en). El alto lo anuncia el propio caset (mira el punto 4).
3. Sin código
Pega el enlace https://caset.es/e/charms en WordPress, Notion, Ghost o cualquier editor que admita oEmbed, y se inserta solo.
4. Tu propio mini reproductor
Por ejemplo, uno que flote cuando el lector baja por el artículo. Con insertar.js, el caset te cuenta lo que pasa y obedece a tus botones:
// lo que pasa (cada vez que cambia algo)
window.addEventListener('caset', (e) => {
const { id, idioma, reproduciendo, segundo, duracion } = e.detail
})
// tus botones
window.caset('charms', 'play') // 'pause' o 'toggle'
window.caset('charms', 'ir', 95) // salta al segundo 95 y suena
Con el iframe a mano, por postMessage. El caset envía:
{ tipo: 'caset', id, idioma, reproduciendo, segundo, duracion }, con lo que pasa;{ tipo: 'caset-alto', id, alto }, con su altura.
Y obedece a { caset: 'play' | 'pause' | 'toggle' } y a { caset: 'ir', segundo: 95 }.
Idiomas
Un caset puede estar narrado en varios idiomas, como una película con varias pistas de audio. Cada idioma tiene su voz, su texto, sus capítulos y, si la hay, la portada del documento en ese idioma. En la cinta, la etiqueta de abajo a la izquierda (ES, EN) dice en qué idioma suena; al pulsarla se elige otro y sigue por la misma parte del texto.
«El gusto no te salvará. Hacer, sí», de Sergio G. Gómez, insertado en inglés con data-idioma="en". Pulsa EN en la cinta para oírlo en español.
<script src="https://caset.es/insertar.js" data-caset="criterio-esdotge" data-idioma="en" async></script>
Con insertar.js no hace falta pedirlo: suena en el idioma de tu página (<html lang="en">), así que el mismo caset sale en inglés en tus posts en inglés y en español en los de español. Si el caset no tiene ese idioma, suena en el suyo. Los idiomas de cada caset están en sus datos: idioma y versiones.
5. Los datos (JSON)
Base: https://app.caset.es/v1. La especificación completa, en OpenAPI 3.1.
| Ruta | Qué devuelve |
|---|---|
GET /casetes | Los casetes que se pueden insertar. Con ?url=<artículo>, el caset de ese artículo, si lo hay. |
GET /casetes/{id} | Título, autor, duración, capítulos, portada, carcasa (color, estilo y encuadre), audio, texto y cómo insertarlo. También idioma (en el que suena) y versiones: el mismo caset en otros idiomas, cada uno con su título, duración, capítulos, portada, audio y texto. |
GET /creadores/{slug} | Los casetes de un creador. |
GET /audio/{id}.mp3 | El audio (admite rangos). |
GET /transcripts/{id}.json | El texto por frases, con los tiempos de cada palabra. |
GET /oembed?url=… | oEmbed (type: rich) para https://caset.es/e/{id}. |
Un caset que no existe, o que no se puede insertar, devuelve 404.
Qué casetes se pueden insertar
Los de FLOC* y los de creadores que son socios de Caset*. El resto son locuciones de artículos de otros autores y medios, y se quedan dentro de Caset* para sus socios.
¿Escribes y quieres tus artículos en caset, en tu web? Apúntate o escríbenos a hola@caset.es.