Solo anteprima — attivazione richiesta

Costruire i download con Insts

Il banco di lavoro Insts qui sotto è la documentazione per un potenziale cliente. La revisione dell'operatore viene prima che venga creata qualsiasi credenziale eseguibile o indennità di chiamata.

InstsConnectJSON su HTTPSLavori asincroniCredenziali con ambito

Quick start

L'host API inizia con credenziali attivate dal supporto su Insts. La vista successiva copre un endpoint tenant assegnato. La pagina mantiene visibile un percorso di chiamata solo server.

URL del tenanthttps://insts.io

AutenticazioneX-API-Key: pending_activation_…

Profilo del clienteInstsConnect

Versione dell'APIv1

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

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

L'archiviazione segreta lato server è il punto di partenza per la sicurezza delle credenziali su Insts. Un banco di ispezione non presenta quindi alcun incorporamento di pacchetti client e non spiega registri o repository pubblici.

Risolvere un collegamento

L'operazione di risoluzione inizia con il rilevamento della fonte su Insts. La vista successiva copre i formati da un URL inviato.

POST/v1/resolveAmbito di applicazione: risolvere

Campo	Tipo	Obbligatorio	Descrizione
`shared_post`	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
}

Il valore restituito invariato è il punto di partenza per l'identificatore di formato su Insts. Una panca di ispezione presenta quindi la disponibilità per link e spiega l'assenza di etichetta di qualità ipotizzata.

Creare e seguire un processo di download

Insts rende la creazione di Job facile da scansionare. La pagina inizia con una preparazione asincrona, passa a una breve richiesta HTTP e dichiara chiaramente l'esecuzione limitata del worker.

POST/v1/jobsAmbito: posti di lavoro

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

curl -X POST https://insts.io/v1/jobs \
  -H "X-API-Key: $INSTS_CONNECT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"shared_post":"https://www.youtube.com/watch?v=VIDEO_ID","asset_option":"18"}'

1202 AccettatoSalva connect_job.

2Stato del sondaggioGET /v1/jobs/{connect_job} 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://insts.io/v1/jobs/CONNECT_JOB \
  -H "X-API-Key: $INSTS_CONNECT_SECRET"

Per il polling dei lavori, Insts verifica un'attesa iniziale di un secondo prima di un backoff limitato. Questa panca di ispezione rende anche chiara la consegna temporanea firmata.

Errori prevedibili

Il contratto di errore inizia con una busta non 2xx su Insts. Questa panca di ispezione presenta quindi un ID richiesta di supporto. Il fatto finale è la gestione prevedibile del client.

{
  "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

Insts stabilisce limiti di velocità al momento della revisione per proteggere l'area di ispezione e ogni percorso del provider.

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.

L'accesso allo schema inizia con l'attivazione prima dell'esplorazione su Insts. La vista successiva copre l'autenticazione assegnata. La pagina mantiene visibili le forme di richiesta documentate.

ACCESSO REVISO DALL'OPERATORE

Attivazione tramite supporto

Condividi il caso d'uso del banco di lavoro, il numero stimato di chiamate e i servizi sotto ispezione. Insts esamina quel confine prima che una credenziale del tenant venga mostrata una volta e ridotta a un hash memorizzato.

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.