https://savetk.appBouw downloads met SaveTK
SaveTK toont een API-plan voor integraties van maker-tools, maar accepteert geen niet-geauthenticeerde uitvoering. Goedkeuring levert zowel de sleutel als de operationele limieten.
SaveTkCreatorVerzenden van JSON over HTTPSAsynchrone jobsReferenties met bereik
01
Snel aan de slag
SaveTK presenteert drie praktische punten voor API-host. Eerst komen ondersteuningsgeactiveerde referenties. De opslagworkflow behandelt vervolgens een toegewezen tenant-eindpunt. Het laatste punt is een server-only oproeppad.
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 maakt het gemakkelijk om Credential-veiligheid te scannen. De pagina begint met server-side geheime opslag, gaat over naar geen client-bundel embedding, en vermeldt duidelijk dat er geen openbare logs of repositories zijn.
02
Een koppeling oplossen
SaveTK presenteert drie praktische punten voor Resolve-operatie. Eerst komt bronherkenning. De opslagworkflow behandelt vervolgens formaten van één ingediende URL. Het laatste punt is dat er geen verzonnen uitvoer is.
POST
/v1/resolveToepassingsgebied: oplossen| Veld | Type | Vereist | Beschrijving |
|---|---|---|---|
creator_link | HTTPS-URL | Ja. | Openbare of geautoriseerde mediapagina om te analyseren. |
tenant | tekenreeks | Nee. | Toegewezen tenantdomein. Meestal weggelaten. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}SaveTK maakt Formaatidentificatie gemakkelijk scanbaar. De pagina begint met de ongewijzigde geretourneerde waarde, gaat verder met beschikbaarheid per link en vermeldt duidelijk dat er geen geraden kwaliteitslabel is.
03
Maak en volg een downloadtaak
Taakcreatie begint met asynchrone voorbereiding op SaveTK. Deze besparingsworkflow presenteert vervolgens een korte HTTP-aanvraag. Het laatste feit is begrensde uitvoering door de worker.
POST
/v1/jobsScope: vacatures| Veld | Type | Vereist | Beschrijving |
|---|---|---|---|
creator_link | HTTPS-URL | Ja. | Dezelfde genormaliseerde bron ingediend om op te lossen. |
save_option | tekenreeks | Ja. | Een exacte ID uit de resolve-respons. |
tenant | tekenreeks | Nee. | Toegewezen tenantdomein. Meestal weggelaten. |
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} met dezelfde sleutel.| Status | Betekenis | Actie van de klant |
|---|---|---|
queued | Toegestaan in de beperkte wachtrij. | Poll weer met achteruit. |
extracting | Bronmetadata of route vernieuwen. | Ga door met pollen. |
processing | Bezig met downloaden, remuxen of samenvoegen. | Toon server voortgang. |
ready | Ondertekende download is beschikbaar. | Stuur de URL naar de gebruiker. |
failed | Terminal gestructureerde fout. | Lees error_codeProbeer het alleen opnieuw als dat wordt geadviseerd. |
expired | Tijdelijke uitvoer werd verwijderd. | Maak een nieuwe taak aan. |
curl https://savetk.app/v1/jobs/SAVE_TASK \
-H "X-API-Key: $SAVETK_CREATOR_KEY"SaveTK verwerkt Job polling door eerst een initiële wachttijd van één seconde te identificeren. Daarna volgt een begrensde backoff en wordt tijdelijke ondertekende levering in het oog gehouden.
04
Voorspelbare fouten
Het foutcontract begint met één niet-2xx envelop op SaveTK. De volgende weergave behandelt een ondersteuningsverzoek-ID. De pagina houdt voorspelbare clientafhandeling zichtbaar.
{
"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 | Typische betekenis | Actie |
|---|---|---|
| 400 | Ongeldige URL, body of niet beschikbare indeling. | Corrigeer de aanvraag. Los opnieuw op voor formaten. |
| 401 | Ontbrekende, ongeldige, verlopen of verkeerd bereik sleutel. | Controleer de serverzijde referentie. |
| 403 | Tenant of bronbeleid heeft de aanvraag afgewezen. | Omzeil het beleid niet. Neem contact op met de ondersteuning. |
| 404 | Onbekende of verlopen vacature. | Maak indien nodig een nieuwe taak aan. |
| 429 | Aanvraag- of actieve-taaklimiet bereikt. | Eer retry_after_seconds. |
| 503 | Wachtrij/capaciteit of upstream tijdelijk niet beschikbaar. | Probeer het opnieuw met exponentiële backoff en jitter. |
05
Operationeel contract
SaveTK stelt toeslagen voor maker-workflow in na onderzoek van het verwachte verkeer en de publicatieplatforms in het bereik.
- Gebruik idempotente toepassingslogica en start nooit dubbele taken voor dezelfde gebruikersklik.
- Cache lost metadata kort op, maar behandelt ondertekende download-URL's altijd als verlopen.
- Gebruik begrensde exponentiële backoff met jitter voor
429,503en herprobeerbare fouten. - Verwerk alleen openbare media of media waarvoor u toegangsrechten hebt, en vermijd het omzeilen van DRM en toegangscontrole.
- Bewaar verzoek-ID's en taak-ID's in privé-operationele logboeken. Log niet onnodig verzonden URL's.
SaveTK presenteert drie praktische punten voor Schema-toegang. Eerst komt activatie vóór verkenning. De opslagworkflow behandelt vervolgens toegewezen authenticatie. Het laatste punt is gedocumenteerde aanvraagvormen.
Activeren via ondersteuning
Geef aan wat de SaveTK-client doet, hoeveel oproepen het verwacht en welke plaatsingsdiensten essentieel zijn. De ondersteuningsbeoordeling selecteert zijn reikwijdtes en retourneert vervolgens een niet-herstelbare referentie die één keer wordt getoond.
Vraag activering aan Sleutels zijn tenant-gebonden, intrekbaar en worden uitgegeven via het contactformulier. Anonieme scripts kunnen geen downloadprogramma-taken uitvoeren.