APIhttps://gateway.streamfizz.live/apiCrée un nouveau média à partir d'une URL de fichier vidéo ou audio. Le téléchargement et l'encodage sont effectués en arrière-plan.
| Nom | Type | Description |
|---|---|---|
videoUrl* | String! | URL publique du fichier à importer. Formats vidéo supportés : MP4, AVI, MOV, WebM, OGG. Formats audio supportés : MP3, WAV, OGG, AAC, FLAC. L'URL doit être accessible sans authentification. |
title | String | Titre du média. Si non fourni, le nom du fichier sera utilisé. |
ownerId | ID | ID de l'utilisateur propriétaire du média. Si non fourni, l'utilisateur associé à la clé API sera utilisé. L'utilisateur doit appartenir au même compte que la clé API. |
MediaPour suivre la progression du téléchargement source d'un média après sa création, interrogez les champs suivants sur le type Media. L'état détaillé de l'encodage est quant à lui disponible via le champ encodingProgress de type EncodingProgress.
{
getMedia(id: "MEDIA_ID") {
hasDownload
downloadProgress
downloadLastUpdate
downloadDone
downloadFailed
}
}| Nom | Type | Description |
|---|---|---|
hasDownload | Boolean! | Indique si un téléchargement source est associé à ce média. |
downloadProgress | Int! | Progression du téléchargement source en pourcentage (0–100). |
downloadLastUpdate | DateTime | Date de la dernière mise à jour de la progression. |
downloadDone | Boolean! | Indique si le téléchargement source est terminé avec succès. |
downloadFailed | Boolean! | Indique si le téléchargement source a échoué. |
| Code | Message | Description |
|---|---|---|
UNAUTHENTICATED | You are not authorized to perform this action | Clé API manquante ou invalide |
INPUT_VALIDATION_ERROR | Validation failed: {field}: {message} | Un ou plusieurs champs sont invalides (format, longueur, protocole…). Le détail est dans extensions.fieldErrors[]. |
INTERNAL_ERROR | Internal server error | Erreur interne du serveur |
| Code | Message | Description |
|---|---|---|
URL_UNREACHABLE | Unable to reach URL | Impossible de se connecter au serveur (DNS, timeout, connexion refusée) |
URL_ACCESS_DENIED | Cannot access URL | Accès refusé ou ressource non trouvée (403, 404) |
INVALID_OWNER | Invalid ownerId - user not found or not in account | L'ownerId n'existe pas ou n'appartient pas au compte |
60 requêtes par minute par clé API
En cas de dépassement, une erreur 429 Too Many Requests est retournée.