Solo anteprima — attivazione richiesta

Costruire i download con Insto

Insto presenta un modello di integrazione dei media visivi per la valutazione. L'analisi in tempo reale e le richieste di lavoro rimangono non disponibili fino a quando il supporto non concede l'autorizzazione a livello di tenant.

InstoMediaJSON su HTTPSLavori asincroniCredenziali con ambito

Quick start

Per l'host API, Insto inizia con credenziali attivate dal supporto. La sua revisione del download abbina questo a un endpoint tenant assegnato e termina con un percorso di chiamata solo server.

URL del tenanthttps://insto.app

AutenticazioneX-API-Key: pending_activation_…

Profilo del clienteInstoMedia

Versione dell'APIv1

# Available only after support activation
export INSTO_MEDIA_TOKEN="issued-after-review"

curl -X POST https://insto.app/v1/resolve \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"media_source":"https://www.youtube.com/watch?v=VIDEO_ID"}'

Insto presenta tre punti pratici per la sicurezza delle credenziali. Il primo è l'archiviazione segreta lato server. La revisione del download copre poi nessun embedding di bundle client. Il punto finale è nessun registro pubblico o repository.

Risolvere un collegamento

Per l'operazione Resolve, Insto inizia con il rilevamento della fonte. La sua revisione del download abbina questo con formati da un URL inviato e termina senza output inventati.

POST/v1/resolveAmbito di applicazione: risolvere

Campo	Tipo	Obbligatorio	Descrizione
`media_source`	URL HTTPS	Sì	Pagina media pubblica o autorizzata da analizzare.
`tenant`	stringa	No.	Dominio tenant assegnato. In genere omesso.

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

Insto presenta tre punti pratici per l'identificatore di formato. Prima viene il valore restituito invariato. La revisione del download copre quindi la disponibilità per collegamento. Il suo punto finale è nessuna etichetta di qualità indovinata.

Creare e seguire un processo di download

Insto organizza la creazione di lavoro attorno alla preparazione asincrona. La sua revisione del download confronta una breve richiesta HTTP. L'esecuzione del lavoratore limitato rimane il controllo finale.

POST/v1/jobsAmbito: posti di lavoro

Campo	Tipo	Obbligatorio	Descrizione
`media_source`	URL HTTPS	Sì	La stessa fonte normalizzata è stata inviata per la risoluzione.
`media_variant`	stringa	Sì	Un ID esatto dalla risposta di risoluzione.
`tenant`	stringa	No.	Dominio tenant assegnato. In genere omesso.

curl -X POST https://insto.app/v1/jobs \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"media_source":"https://www.youtube.com/watch?v=VIDEO_ID","media_variant":"18"}'

1202 AccettatoSalva prepare_id.

2Stato del sondaggioGET /v1/jobs/{prepare_id} con la stessa chiave.

3ProntoAprire l'URL di download firmato.

Stato	Significato	Azione del cliente
`queued`	Ammesso alla coda limitata.	Sondaggio di nuovo con backoff.
`extracting`	Aggiornamento dei metadati di origine o della rotta.	Continua a sondare.
`processing`	Scaricare, remux o unire.	Visualizza il progresso del server.
`ready`	Il download firmato è disponibile.	Invia l'URL all'utente.
`failed`	Errore strutturato terminale.	Leggi `error_code`Riprova solo quando ti viene consigliato.
`expired`	L'uscita temporanea è stata rimossa.	Creare un nuovo lavoro.

curl https://insto.app/v1/jobs/PREPARE_ID \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN"

In Insto, un'attesa iniziale di un secondo viene prima quando si spiega il polling del lavoro. La revisione del download segue con backoff limitato e si chiude con la consegna temporanea firmata.

Errori prevedibili

Per spiegare il contratto di errore, Insto separa un involucro non 2xx da un ID di richiesta di supporto. Una revisione del download offre una gestione prevedibile del cliente in un proprio spazio.

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "category": "rate_limited",
    "message": "Too many requests. Please try again shortly.",
    "retryable": true,
    "details": {"retry_after_seconds": 20}
  },
  "request_id": "…"
}

HTTP	Significato tipico	Azione
400	URL, corpo o formato non valido.	Correggi la richiesta. Risolvi di nuovo per i formati.
401	Chiave mancante, non valida, scaduta o con ambito errato.	Verificare le credenziali lato server.
403	Criterio di tenant o di origine ha rifiutato la richiesta.	Non aggirare la politica. Contattare l'assistenza.
404	Offerta di lavoro sconosciuta o scaduta.	Creare un nuovo lavoro, se del caso.
429	Richiesta o limite di lavori attivi raggiunto.	Onore `retry_after_seconds`.
503	Coda/capacità o upstream temporaneamente non disponibile.	Riprova con backoff esponenziale e jitter.

Contratto operativo

Insto adatta i limiti di chiamata al caso d'uso dei media visivi e alle reti che il client approvato contatterà.

Usa una logica applicativa idempotente e non avviare mai lavori duplicati per lo stesso clic dell'utente.
Memorizza brevemente i metadati di risoluzione, ma considera sempre le URL di download firmate come scadute.
Usa il backoff esponenziale limitato con jitter per 429, 503 e errori riprovabili.
Elabora solo media pubblici o media a cui sei autorizzato ad accedere. DRM e controlli di accesso non vengono bypassati.
Conserva gli ID delle richieste e gli ID dei lavori nei registri operativi privati. Non registrare inutilmente gli URL inviati.

Per l'accesso allo Schema, Insto inizia con l'attivazione prima dell'esplorazione. La sua revisione del download abbina ciò all'autenticazione assegnata e termina con forme di richiesta documentate.

ACCESSO REVISO DALL'OPERATORE

Attivazione tramite supporto

Delinea il prodotto multimediale visivo, l'uso mensile previsto e i tipi di post che intendi gestire. Insto concede solo gli ambiti di analisi o preparazione necessari e non memorizza mai il token leggibile.

Richiedi attivazione Le chiavi sono limitate all'inquilino, revocabili e rilasciate tramite il modulo di contatto. Gli script anonimi non possono eseguire lavori di download.