Documentation

Référence API

Réessayer l'archivage du fichier

POST/v1/files/{file_id}/retry

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.

Récupération après échec de sauvegarde

Vérifiez d'abord l'espace disponible et la cause de l'erreur. Cette opération réserve à nouveau de la capacité de stockage et archive le résultat initial, sans rappeler le service de génération ni modifier les frais de la tâche. Si la source initiale a expiré, la nouvelle tentative peut encore échouer.

Gérez les fichiers protégés par les références de tâches persistantes au travers du cycle de vie des tâches ; ne supprimez pas un fichier référencé pour libérer de l'espace. Vérifiez séparément comptabilité et stockage. Voir Facturation.

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

Archivage du fichier relancé

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