https://gateway.streamfizz.live/api/upload/initUpload en deux étapes pour les fichiers volumineux. L'endpoint /init retourne la liste des URLs presignées pour chaque part ; après les PUT, l'endpoint /complete finalise l'upload.
| Header | Type | Requis | Description |
|---|---|---|---|
x-api-key | string | Oui | Clé API du compte |
https://gateway.streamfizz.live/api/upload/initInitie l'upload multipart et retourne la liste des URLs presignées pour chaque part.
| Champ | Type | Requis | Description |
|---|---|---|---|
filename | string | Oui | Nom original du fichier. Une extension .vtt, .srt ou .csv est exigée pour les sous-titres et les CSV ; pour la vidéo, l'audio et les images, seul mimeType est contrôlé |
mimeType | string | Oui | Type MIME du fichier |
size | number | Oui | Taille du fichier en octets, nombre entier (au-delà de 5 Gio — en deçà, l'init renvoie le mode simple) |
{
"completeEndpoint": "https://gateway.streamfizz.live/api/upload/{uploadId}/complete",
"key": "{accountId}/api-uploads/media/{uuid}/big-video.mp4",
"mode": "multipart",
"partSize": 104857600,
"parts": [
{
"partNumber": 1,
"url": "https://s3.fr-par.scw.cloud/..."
},
{
"partNumber": 2,
"url": "https://s3.fr-par.scw.cloud/..."
},
{
"partNumber": "N",
"url": "... (une URL presignée par part)"
}
],
"success": true,
"uploadId": "2~abcXYZ..."
}| Champ | Type | Description |
|---|---|---|
success | boolean | true si l'init a réussi |
mode | "multipart" | Mode d’upload (toujours "multipart" ici) |
uploadId | string | Identifiant multipart S3 |
key | string | Clé S3 de destination (à renvoyer au /complete) |
partSize | number | Taille de chaque part en octets — variable selon la taille du fichier (75 Mio jusqu'à 10 Gio, 100 Mio au-delà) : à lire dans la réponse, jamais à supposer |
parts | array | Liste des URLs presignées par part { partNumber, url } — valables 4h à compter de l'init, sans moyen de les régénérer |
completeEndpoint | string | URL https à appeler pour finaliser l'upload |
| HTTP | Code | Description |
|---|---|---|
400 | INVALID_BODY | Champ manquant (filename, mimeType), ou champ inconnu : le corps n'accepte que ces trois clés et rejette tout ajout, même inoffensif. |
400 | INVALID_SIZE | size absent, non entier ou non positif |
400 | INVALID_MIME_TYPE | Type de fichier non autorisé |
401 | UNAUTHORIZED | Clé API manquante ou invalide |
413 | FILE_TOO_LARGE | Le fichier dépasse 100 Gio |
429 | RATE_LIMITED | Trop de requêtes |
500 | INIT_FAILED | Échec de l'initialisation S3 |
500 | INTERNAL_ERROR | Erreur interne du serveur |
https://gateway.streamfizz.live/api/upload/{uploadId}/completeFinalise l'upload après que toutes les parts ont été PUT avec succès à S3. À appeler une fois tous les ETags collectés depuis les réponses PUT, avec toutes les parts annoncées à l'init. L'objet assemblé est ensuite vérifié : s'il ne fait pas size octets, il est supprimé et l'appel répond 422 UPLOAD_MISMATCH.
| Champ | Type | Description |
|---|---|---|
key | string | Clé S3 reçue à l'init |
parts | array | Liste { partNumber, etag } (ETag sans guillemets) : toutes les parts annoncées à l'init, numérotées de 1 à N, chacune une fois |
{
"downloadUrl": "https://s3.fr-par.scw.cloud/streamfizz-prod/...?X-Amz-Algorithm=...&X-Amz-Signature=...",
"expiresAt": "2026-09-01T10:00:00.000Z",
"key": "{accountId}/api-uploads/media/{uuid}/big-video.mp4",
"success": true
}| Champ | Type | Description |
|---|---|---|
success | boolean | true si la finalisation a réussi |
key | string | Clé S3 finale de l'objet |
downloadUrl | string | URL de téléchargement presignée (validité 24h) |
expiresAt | string | Date ISO 8601 au-delà de laquelle le downloadUrl n'est plus valable |
| HTTP | Code | Description |
|---|---|---|
400 | INVALID_BODY | Corps invalide, parts manquant ou mal formé |
400 | INCOMPLETE_PARTS | La liste parts ne couvre pas exactement les parts annoncées à l'init (une part manquante, en trop ou répétée). Rien n'est finalisé : corrigez la liste et rappelez /complete. |
400 | INVALID_PART | Un etag ne correspond à aucune part envoyée pour ce partNumber (ETag recopié de travers, PUT de la part échoué ou jamais fait). Rien n'est finalisé : renvoyez la part fautive puis rappelez /complete. |
401 | UNAUTHORIZED | Clé API manquante ou invalide |
403 | FORBIDDEN_KEY | La key ne correspond pas à votre accountId |
404 | UPLOAD_NOT_FOUND | Upload multipart introuvable, déjà finalisé, ou initié il y a plus de 24 h |
422 | UPLOAD_MISMATCH | L'objet assemblé n'a pas la taille (size) déclarée à l'init : il est supprimé. Relancez l'upload depuis /init. |
429 | RATE_LIMITED | Trop de requêtes |
500 | COMPLETE_FAILED | Échec de la finalisation côté stockage |
500 | INTERNAL_ERROR | Erreur interne du serveur |
Exemple bout-en-bout : init → PUT chaque part en parallèle → complete.
5 requêtes par minute par clé API, partagées entre /init et /complete
En cas de dépassement, une erreur 429 Too Many Requests est retournée avec un champ retryAfter indiquant le délai en secondes.