Documentación de la API

La API de NexMedia es REST sobre HTTPS, de mismo origen bajo /v1, con eventos enviados por el servidor para el progreso en vivo.

Identidad: POST /v1/identity/guest crea una cuenta de invitado y establece una cookie de identidad; cada llamada posterior se autoriza con ella. Sin registro, sin clave de API para el uso desde el navegador.

Subidas: POST /v1/uploads emite un ticket con URLs presignadas de corta duración. Envíe los bytes directamente al almacenamiento con PUT — la API nunca transporta bytes de archivos — y finalice con POST /v1/uploads/:id/complete para que el archivo sea inspeccionado y aceptado.

Conversiones: POST /v1/jobs crea un trabajo de conversión a partir de un blob de origen y uno o más formatos de destino. GET /v1/jobs/:id devuelve su estado, GET /v1/jobs/:id/events transmite el progreso en vivo como SSE (reproducible con Last-Event-ID) y GET /v1/jobs/:id/outputs lista los enlaces de descarga firmados cuando el trabajo se completa.

Descargas: GET /v1/downloads/* sirve los archivos de salida mediante enlaces firmados que caducan poco después de emitirse; la propia firma autoriza la descarga.