https://savetk.appCostruire i download con SaveTK
SaveTK visualizza un piano API per le integrazioni tra creatore e strumento, ma non accetta l'esecuzione non autenticata. Approval fornisce sia la chiave che i relativi limiti operativi.
SaveTkCreatorJSON su HTTPSLavori asincroniCredenziali con ambito
01
Quick start
SaveTK presenta tre punti pratici per l'host API. Il primo riguarda le credenziali attivate dal supporto. Il flusso di salvataggio copre quindi un endpoint tenant assegnato. Il punto finale è un percorso di chiamata solo server.
X-API-Key: pending_activation_…SaveTkCreatorv1# Available only after support activation
export SAVETK_CREATOR_KEY="issued-after-review"
curl -X POST https://savetk.app/v1/resolve \
-H "X-API-Key: $SAVETK_CREATOR_KEY" \
-H "Content-Type: application/json" \
-d '{"creator_link":"https://www.youtube.com/watch?v=VIDEO_ID"}'SaveTK rende facile la scansione della sicurezza delle Credenziali. La pagina inizia con l'archiviazione segreta lato server, passa a nessun embedding di bundle client e dichiara chiaramente l'assenza di registri o repository pubblici.
02
Risolvere un collegamento
SaveTK presenta tre punti pratici per l'operazione Resolve. Il primo è il rilevamento della fonte. Il flusso di lavoro di salvataggio copre quindi i formati da un URL inviato. Il punto finale è nessuna uscita inventata.
POST
/v1/resolveAmbito di applicazione: risolvere| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
creator_link | 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
}SaveTK rende l'identificatore di formato facile da scansionare. La pagina inizia con il valore restituito invariato, passa alla disponibilità per link e indica chiaramente l'assenza di un'etichetta di qualità ipotizzata.
03
Creare e seguire un processo di download
La creazione del lavoro inizia con la preparazione asincrona su SaveTK. Questo flusso di lavoro di salvataggio presenta quindi una breve richiesta HTTP. Il fatto finale è l'esecuzione limitata del lavoratore.
POST
/v1/jobsAmbito: posti di lavoro| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
creator_link | URL HTTPS | Sì | La stessa fonte normalizzata è stata inviata per la risoluzione. |
save_option | stringa | Sì | Un ID esatto dalla risposta di risoluzione. |
tenant | stringa | No. | Dominio tenant assegnato. In genere omesso. |
curl -X POST https://savetk.app/v1/jobs \
-H "X-API-Key: $SAVETK_CREATOR_KEY" \
-H "Content-Type: application/json" \
-d '{"creator_link":"https://www.youtube.com/watch?v=VIDEO_ID","save_option":"18"}'save_task.GET /v1/jobs/{save_task} con la stessa chiave.| 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_codeRiprova solo quando ti viene consigliato. |
expired | L'uscita temporanea è stata rimossa. | Creare un nuovo lavoro. |
curl https://savetk.app/v1/jobs/SAVE_TASK \
-H "X-API-Key: $SAVETK_CREATOR_KEY"SaveTK gestisce il polling del Job identificando prima un'attesa iniziale di un secondo. Segue con backoff limitato e mantiene in vista la consegna temporanea firmata.
04
Errori prevedibili
Il contratto di errore inizia con una busta non 2xx su SaveTK. La visualizzazione successiva copre un ID di richiesta di supporto.
{
"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. |
05
Contratto operativo
SaveTK imposta le autorizzazioni per il flusso di lavoro del creatore dopo aver esaminato il traffico previsto e le piattaforme di pubblicazione nell'ambito.
- 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,503e 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.
SaveTK presenta tre punti pratici per l'accesso allo Schema. Il primo è l'attivazione prima dell'esplorazione. Il flusso di lavoro di salvataggio copre quindi l'autenticazione assegnata. Il suo punto finale sono le forme di richiesta documentate.
Attivazione tramite supporto
Dichiara cosa fa il client SaveTK, quante chiamate si aspetta e quali servizi di pubblicazione sono essenziali. La revisione del supporto seleziona i suoi ambiti, quindi restituisce una credenziale non recuperabile mostrata una sola 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.