API-Dokumentation

Die NexMedia-API ist REST über HTTPS, same-origin unter /v1, mit Server-Sent Events für Live-Fortschritt.

Identität: POST /v1/identity/guest legt ein Gastkonto an und setzt ein Identitäts-Cookie; jeder spätere Aufruf wird darüber autorisiert. Keine Registrierung, kein API-Schlüssel für die Browser-Nutzung.

Uploads: POST /v1/uploads stellt ein Ticket mit kurzlebigen presigned URLs aus. Übertragen Sie die Bytes direkt zum Speicher — die API trägt nie Datei-Bytes — und schließen Sie mit POST /v1/uploads/:id/complete ab, damit die Datei geprüft und akzeptiert wird.

Konvertierungen: POST /v1/jobs erstellt einen Konvertierungsauftrag aus einem Quell-Blob und einem oder mehreren Zielformaten. GET /v1/jobs/:id liefert den Zustand, GET /v1/jobs/:id/events streamt den Live-Fortschritt als SSE (mit Last-Event-ID wiederholbar), und GET /v1/jobs/:id/outputs listet signierte Download-Links, sobald der Job abgeschlossen ist.

Downloads: GET /v1/downloads/* stellt Ausgabedateien über signierte Links bereit, die kurz nach ihrer Ausstellung ablaufen; die Signatur selbst berechtigt zum Download.