Documentazione

Riferimento API

Riprova l'archiviazione del file

POST/v1/files/{file_id}/retry

Cronologia dei file dello stesso account e della stessa Key. Una Key valida con quota esaurita è accettata, non una revocata o scaduta. Il download richiede ready; eliminazione con riferimenti attivi: 409. retry salva il risultato originale senza rigenerarlo. L'API ordinaria segue i giorni di conservazione; le attività persistenti proteggono i riferimenti, expires_at=0 indica nessuna scadenza fissa.

Recupero dopo un errore di salvataggio

Controlla prima lo spazio disponibile e la causa dell'errore. Questa operazione richiede nuovamente capacità di storage e archivia il risultato originale, senza richiamare il servizio di generazione o cambiare i costi dell'attività. Se la fonte originale è scaduta, il nuovo tentativo può comunque fallire.

Gestisci i file protetti dai riferimenti delle attività persistenti attraverso il ciclo di vita dell'attività. Non liberare spazio eliminando file referenziati. Verifica separatamente gli stati contabili e dello storage; vedi Fatturazione.

Autenticazione e autorizzazioni

Usa la chiave GloopAPI corrente. Modelli, funzionalità e autorizzazioni disponibili dipendono dal relativo catalogo e dalla documentazione dell'endpoint.

Authorization: Bearer $GLOOP_API_KEY

Schemi di autenticazione: BearerAuth

Richiesta

Parametri del percorso

  • file_idstringObbligatorio

    ID pubblico del file ospitato della stessa Key.

Risposte ed errori

HTTP 200

Archiviazione del file riprovata

application/json

Tipo
object
Campi obbligatori
idsource_kindsource_indexmodelstatusmime_typefile_namesize_bytescreated_atupdated_atexpires_at
  • idstringObbligatorio

    Identificatore pubblico dell'oggetto, usato nel relativo percorso dei dettagli.

  • source_kindstringObbligatorio

    Categoria di origine del file, che determina ciclo di vita e protezione dei riferimenti.

  • source_indexintegerObbligatorio

    Indice dell'elemento del risultato sorgente.

  • modelstringObbligatorio

    ID pubblico del modello nel catalogo della Key corrente.

  • statusstringObbligatorio

    Fasi di storage in background come waiting/pending/archiving/ready/failed/deleting; URL di download solo dopo ready.

  • mime_typestringObbligatorio

    Tipo MIME del file verificato.

  • file_namestringObbligatorio

    Nome pubblico del file scaricato.

  • sha256stringFacoltativo

    SHA-256 del contenuto archiviato, restituito se determinato.

  • size_bytesintegerObbligatorio

    Dimensione del file in byte.

  • error_codestringFacoltativo

    Codice errore pubblico utilizzabile per scegliere il ramo di gestione.

  • created_atintegerObbligatorio

    Ora di creazione in secondi Unix.

  • updated_atintegerObbligatorio

    Ultimo aggiornamento in secondi Unix.

  • expires_atintegerObbligatorio

    Secondi Unix; 0 indica conservazione a lungo termine. L'API ordinaria segue i giorni del deployment; i riferimenti persistenti immagine/video proteggono i risultati. Contabilità e idempotenza restano dopo l'eliminazione.

HTTP 400

Campi o parametri della richiesta non validi.

application/json

Tipo
object
Campi obbligatori
error

HTTP 401

Key assente, non valida, scaduta o revocata.

application/json

Tipo
object
Campi obbligatori
error

HTTP 403

Autorizzazioni IP, account, modello o strumento insufficienti.

application/json

Tipo
object
Campi obbligatori
error

HTTP 404

Oggetto/funzionalità non disponibile o disabilitata.

application/json

Tipo
object
Campi obbligatori
error

HTTP 409

Conflitto di idempotenza/preventivo, oggetto non pronto o ancora referenziato.

application/json

Tipo
object
Campi obbligatori
error

HTTP 429

Limite di frequenza delle richieste/della coda.

application/json

Tipo
object
Campi obbligatori
error

HTTP 500

Errore interno di autenticazione o storage dei dati.

application/json

Tipo
object
Campi obbligatori
error

HTTP 503

Servizio, prezzi o storage non disponibile.

application/json

Tipo
object
Campi obbligatori
error