Documentazione

Riferimento API

Ottieni un URL temporaneo di download

GET/v1/files/{file_id}/download-url

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.

Riproduzione e download

Leggi prima lo stato del file, poi richiedi un URL temporaneo di download. Se lo storage non è ready, ottenere l'URL non rende disponibile il file in anticipo. Invia la Key originale soltanto a GloopAPI, senza allegarla al download dall'indirizzo HTTPS restituito.

I video persistenti usano URL temporanei dello storage a oggetti per la riproduzione Range nativa. Il GET completo del percorso content dei video ordinari usa un trasporto diverso. Se il collegamento scade, ottieni un nuovo URL. Se il file è scaduto o è stato eliminato, aggiornare il collegamento non lo ripristina.

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

URL temporaneo di download ottenuto

application/json

Tipo
object
Campi obbligatori
urlexpires_at
  • urlstringObbligatorio

    URL temporaneo firmato di download; non divulgarlo né conservarlo a lungo.

    Formato
    "uri"
  • expires_atintegerObbligatorio

    Secondi Unix.

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