Documentazione

Riferimento API

Consulta i file ospitati

GET/v1/files

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.

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 di query

  • afterintegerFacoltativo

    Usa next_cursor della risposta originale; il servizio fissa 50 elementi per pagina.

    Valore predefinito
    0
    Minimo
    0

Risposte ed errori

HTTP 200

File ospitati consultati

application/json

Tipo
object
Campi obbligatori
datanext_cursor
  • dataarrayObbligatorio
    Campi figli di data (1)
    • []objectFacoltativo
      Campi figli di [] (13)
      • 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.

  • next_cursorintegerObbligatorio

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