Documentation

Référence API

Obtenir une URL temporaire de téléchargement

GET/v1/files/{file_id}/download-url

Historique des fichiers du même compte et de la même Key. Une Key valide épuisée est acceptée, mais pas une Key révoquée ou expirée. Téléchargement exige ready ; suppression d'une référence active : 409. retry sauvegarde le résultat original sans régénérer. L'API ordinaire suit la durée de conservation ; les tâches persistantes protègent les références, expires_at=0 signifie sans échéance fixe.

Lecture et téléchargement

Consultez d'abord l'état du fichier, puis demandez une URL de téléchargement temporaire ; si le stockage n'est pas ready, obtenir une URL ne rend pas le fichier disponible plus tôt. N'envoyez la Key d'origine qu'à GloopAPI et ne la joignez pas au téléchargement depuis l'adresse HTTPS retournée.

La vidéo persistante utilise une URL temporaire de stockage objet pour la lecture native avec Range ; le GET complet du chemin content d'une vidéo ordinaire utilise un transport différent. Si le lien expire, obtenez une nouvelle URL ; si le fichier a expiré ou a été supprimé, actualiser le lien ne le restaure pas.

Authentification et autorisations

Utilisez votre clé GloopAPI actuelle. Les modèles, capacités et autorisations disponibles dépendent de son catalogue et de la documentation du point de terminaison.

Authorization: Bearer $GLOOP_API_KEY

Schémas d'authentification : BearerAuth

Requête

Paramètres de chemin

  • file_idstringObligatoire

    ID public du fichier hébergé de la même Key.

Réponses et erreurs

HTTP 200

URL temporaire de téléchargement obtenue

application/json

Type
object
Champs obligatoires
urlexpires_at
  • urlstringObligatoire

    URL temporaire signée de téléchargement ; ne la divulguez pas et ne la conservez pas durablement.

    Format
    "uri"
  • expires_atintegerObligatoire

    Secondes Unix.

HTTP 400

Champs ou paramètres de requête invalides.

application/json

Type
object
Champs obligatoires
error

HTTP 401

Key absente, invalide, expirée ou révoquée.

application/json

Type
object
Champs obligatoires
error

HTTP 403

Autorisations IP, compte, modèle ou outil insuffisantes.

application/json

Type
object
Champs obligatoires
error

HTTP 404

Objet/capacité indisponible ou fonctionnalité désactivée.

application/json

Type
object
Champs obligatoires
error

HTTP 409

Conflit d'idempotence/devis, objet non prêt ou encore référencé.

application/json

Type
object
Champs obligatoires
error

HTTP 429

Limitation de débit des requêtes/de la file.

application/json

Type
object
Champs obligatoires
error

HTTP 500

Défaillance interne d'authentification ou de stockage des données.

application/json

Type
object
Champs obligatoires
error

HTTP 503

Service, tarification ou stockage indisponible.

application/json

Type
object
Champs obligatoires
error