https://quickt.ioBouw downloads met QuickT
QuickT documenteert hoe een mobiele client met de service zou communiceren. Het kan geen productiewerk indienen totdat ondersteuning het ontwerp goedkeurt en gescopeerde toegang inschakelt.
Snel aan de slag
Voor API-host controleert QuickT eerst ondersteuningsgeactiveerde referenties voordat een toegewezen tenant-eindpunt wordt benaderd. Deze apparaatklare weergave maakt ook een server-only oproeppad duidelijk.
X-API-Key: pending_activation_…QuicktRoutev1# 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 organiseert Credential-veiligheid rond serverzijde geheime opslag. De apparaat-klaar weergave vergelijkt geen client-bundel embedding. Geen openbare logs of repositories blijven de laatste controle.
Een koppeling oplossen
Voor Resolve-operatie controleert QuickT brondetectie voordat formaten van één ingediende URL worden verwerkt. Deze apparaatklare weergave maakt ook duidelijk dat er geen verzonnen outputs zijn.
/v1/resolveToepassingsgebied: oplossen| Veld | Type | Vereist | Beschrijving |
|---|---|---|---|
route_source | 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
}QuickT organiseert Formaatidentificatie rond de ongewijzigde geretourneerde waarde. De apparaatklare weergave vergelijkt beschikbaarheid per link. Geen geraden kwaliteitslabel blijft de laatste controle.
Maak en volg een downloadtaak
Om Job creation uit te leggen, scheidt QuickT asynchrone voorbereiding van een korte HTTP-aanvraag. Een apparaatklare weergave geeft gebonden werkuitvoering een eigen plek.
/v1/jobsScope: vacatures| Veld | Type | Vereist | Beschrijving |
|---|---|---|---|
route_source | HTTPS-URL | Ja. | Dezelfde genormaliseerde bron ingediend om op te lossen. |
route_format | tekenreeks | Ja. | Een exacte ID uit de resolve-respons. |
tenant | tekenreeks | Nee. | Toegewezen tenantdomein. Meestal weggelaten. |
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"}'route_job.GET /v1/jobs/{route_job} 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://quickt.io/v1/jobs/ROUTE_JOB \
-H "X-API-Key: $QUICKT_ROUTE_TOKEN"Een initiële wachttijd van één seconde is het startpunt voor Job polling op QuickT. Een apparaat-klaar weergave toont vervolgens begrensde backoff en legt tijdelijke ondertekende levering uit.
Voorspelbare fouten
Voor Foutcontract begint QuickT met één niet-2xx envelop. De apparaat-klaar weergave koppelt dit aan een ondersteuningsverzoek-ID en eindigt met voorspelbare clientafhandeling.
{
"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. |
Operationeel contract
QuickT kiest mobiele clientlimieten tijdens goedkeuring zodat creatornetwerken en de API responsief blijven.
- 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.
Voor Schema-toegang controleert QuickT activatie vóór verkenning en vóór toegewezen authenticatie. Deze apparaat-klaar weergave maakt ook gedocumenteerde aanvraagvormen duidelijk.
Activeren via ondersteuning
Beschrijf de mobiele ervaring, de verkeersverwachting en de creator-netwerken die het nodig heeft. QuickT gebruikt die informatie om analyse- en wachtrijtoestemmingen toe te wijzen voordat het geheim eenmaal wordt onthuld.
Vraag activering aan Sleutels zijn tenant-gebonden, intrekbaar en worden uitgegeven via het contactformulier. Anonieme scripts kunnen geen downloadprogramma-taken uitvoeren.