Caset

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.

Formato
Tema
Colores
Tipografía
Más
OpciónQué hace
data-vistacompleto (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-temaoscuro (de serie) o claro.
data-fondoUn color (#111111) o transparente. La cinta sola va siempre sin fondo, sobre el de tu web.
data-tintaEl color del texto; los grises y las líneas salen de él.
data-acentoEl color del botón de play y de la barra de progreso de la mini.
data-idiomaDe 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-fuenteGeist (de serie) o cualquier familia de Google Fonts, por su nombre.
data-radioEl radio de las esquinas de la mini, en píxeles (0 a 40).
data-texto1 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:

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.

RutaQué devuelve
GET /casetesLos 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}.mp3El audio (admite rangos).
GET /transcripts/{id}.jsonEl 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.