Documentation

Référence API

Consulter les fichiers hébergés

GET/v1/files/{file_id}

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.

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

Fichiers hébergés consultés

application/json

Type
object
Champs obligatoires
idsource_kindsource_indexmodelstatusmime_typefile_namesize_bytescreated_atupdated_atexpires_at
  • idstringObligatoire

    Identifiant public de l'objet, utilisé dans son chemin de détails.

  • source_kindstringObligatoire

    Catégorie de source du fichier, déterminant cycle de vie et protection par références.

  • source_indexintegerObligatoire

    Indice de l'élément du résultat source.

  • modelstringObligatoire

    ID public du modèle dans le catalogue de la Key actuelle.

  • statusstringObligatoire

    Étapes de stockage en arrière-plan : waiting/pending/archiving/ready/failed/deleting, etc. URL de téléchargement seulement après ready.

  • mime_typestringObligatoire

    Type MIME du fichier vérifié.

  • file_namestringObligatoire

    Nom public du fichier téléchargé.

  • sha256stringFacultatif

    SHA-256 du contenu archivé, renvoyé s'il est déterminé.

  • size_bytesintegerObligatoire

    Taille du fichier en octets.

  • error_codestringFacultatif

    Code d'erreur public utilisable pour choisir une branche de traitement.

  • created_atintegerObligatoire

    Date de création en secondes Unix.

  • updated_atintegerObligatoire

    Dernière mise à jour en secondes Unix.

  • expires_atintegerObligatoire

    Secondes Unix ; 0 signifie conservation à long terme. L'API ordinaire suit la durée du déploiement ; les références image/vidéo persistantes protègent les résultats. Comptabilité et idempotence restent après suppression.

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