Tu editor, app o script manda el plan del video y recibe qué corregir antes de renderizar: hook con silencio, palabras cortadas, CTA que falta, sonidos que no existen.
POST /v1/revisarAPI de SHIRUSHI
Las herramientas de SHIRUSHI para tus apps, webs y automatizaciones: revisar planes de edición, el Marketplace de skills y las bibliotecas de sonido. Sin IA adentro: todo es código, rápido y predecible.
Empezar
- Entra a SHIRUSHI → API, llena el formulario corto y revela tu llave. Hay una llave por cuenta y la puedes volver a ver siempre.
- Guárdala en tu servidor como variable de entorno (por ejemplo
SHIRUSHI_LLAVE). No la pongas en el código de una página pública. - Haz tu primera llamada:
Autenticación
Cada llamada lleva tu llave en la cabecera Authorization. Las llaves de la API empiezan con shr_. Si la regeneras en SHIRUSHI, la anterior deja de funcionar al tiro.
Límites y errores
Cada cuenta tiene 1.000 llamadas al día, que se renuevan a medianoche (UTC). Cada respuesta trae dos cabeceras para que sepas dónde vas:
| Cabecera | Qué dice |
|---|---|
x-limite-dia | Tu límite diario de llamadas. |
x-restantes-hoy | Cuántas te quedan hoy. |
Los errores siempre vienen como { "error": "…" } con un mensaje en español que puedes mostrar tal cual.
| Código | Cuándo pasa |
|---|---|
400 | Faltan datos o el formato no es el esperado. |
401 | Falta la llave, no es válida o la regeneraste. |
404 | La ruta, la skill o el sonido no existen (o la skill no es de tu cuenta). |
429 | Pasaste el límite del día. |
500 | Algo falló de nuestro lado. Reintenta en un rato. |
Casos de uso
Para qué la usan los equipos que trabajan con video:
Muestra el catálogo de skills en tu sitio o app, o publica tus skills automáticamente desde tu repositorio cada vez que cambian.
GET /v1/skillsBusca efectos y música de licencia libre desde tu app y baja solo los que usa cada video.
GET /v1/sonidosZapier, Make, n8n, Slack o tu CRM reciben un aviso cuando se crea un video, llega material, un video queda listo o se programa.
POST /v1/webhooksLleva la producción de varios clientes con tu propio sistema: cada cliente con su cuenta y su llave.
Una llave por cuenta
Solo queda en esta pestaña y se usa para los botones «Probar».
Cargando las rutas…
Verificar los avisos
Cada aviso trae la cabecera x-shirushi-firma: t=…,v1=…. Calcula el HMAC-SHA256 de t + "." + cuerpo con tu secreto whsec_… y compáralo con v1. Si no coincide, o si t tiene más de 5 minutos, ignora el aviso. Responde con un 2xx apenas lo recibas.
Cuerpo de ejemplo:
Próximamente
Videos y material por API
Crear videos en el calendario y subir material desde Notion, tu CRM, Zapier, Make o n8n.