Documentation

Référence API

Consulter les fichiers hébergés

GET/v1/files

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 requête

  • afterintegerFacultatif

    Utilisez next_cursor de la réponse d'origine ; le service fixe chaque page à 50 éléments.

    Valeur par défaut
    0
    Minimum
    0

Réponses et erreurs

HTTP 200

Fichiers hébergés consultés

application/json

Type
object
Champs obligatoires
datanext_cursor
  • dataarrayObligatoire
    Sous-champs de data (1)
    • []objectFacultatif
      Sous-champs de [] (13)
      • 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.

  • next_cursorintegerObligatoire

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