Solo anteprima — attivazione richiesta

Costruire i download con QuickT

QuickT Non può inviare il lavoro di produzione finché il supporto non approva il progetto e non abilita l'accesso con ambito.

QuicktRouteJSON su HTTPSLavori asincroniCredenziali con ambito

Quick start

Per l'host API, QuickT controlla le credenziali attivate dal supporto prima di un endpoint tenant assegnato.

URL del tenanthttps://quickt.io

AutenticazioneX-API-Key: pending_activation_…

Profilo del clienteQuicktRoute

Versione dell'APIv1

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

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

QuickT organizza la sicurezza delle credenziali attorno all'archiviazione segreta lato server. La sua visualizzazione pronta per il dispositivo non prevede alcun embedding di bundle client. Nessun registro pubblico o repository rimane come controllo finale.

Risolvere un collegamento

Per l'operazione di risoluzione, QuickT controlla il rilevamento della fonte prima dei formati da un URL inviato.

POST/v1/resolveAmbito di applicazione: risolvere

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

QuickT organizza l'identificatore di formato intorno al valore restituito invariato. La sua vista pronta per il dispositivo confronta la disponibilità per collegamento.

Creare e seguire un processo di download

Per spiegare la creazione di un Job, QuickT separa la preparazione asincrona da una breve richiesta HTTP.

POST/v1/jobsAmbito: posti di lavoro

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

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

1202 AccettatoSalva route_job.

2Stato del sondaggioGET /v1/jobs/{route_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://quickt.io/v1/jobs/ROUTE_JOB \
  -H "X-API-Key: $QUICKT_ROUTE_TOKEN"

L'attesa iniziale di un secondo è il punto di partenza per il polling dei lavori su QuickT.

Errori prevedibili

Per Errore contratto,QuickT La sua vista pronta per il dispositivo accoppia quella con un ID di richiesta di supporto e termina con 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

QuickT sceglie i limiti mobile-client durante l'approvazione in modo che le reti dei creatori e l'API rimangano reattive.

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, QuickT controlla l'attivazione prima dell'esplorazione prima dell'autenticazione assegnata. Questa visualizzazione pronta per il dispositivo rende anche chiare le forme di richiesta documentate.

ACCESSO REVISO DALL'OPERATORE

Attivazione tramite supporto

Descrivi l'esperienza mobile, le sue aspettative di traffico e le reti di creatori di cui ha bisogno. QuickT usa queste informazioni per assegnare analisi e permessi di coda prima di rivelare il segreto una volta.

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.