https://quickt.ioKészítsen letöltéseket QuickT segítségével
A QuickT dokumentálja, hogyan kommunikálna egy mobil kliens a szolgáltatással. Nem nyújthat be gyártási munkát, amíg a támogatás nem hagyja jóvá a tervet és nem engedélyezi a korlátozott hozzáférést.
QuicktRouteJSON HTTPS-en keresztülAszinkron feladatokHatókörrel rendelkező hitelesítő adatok
01
Gyors kezdés
Az API hosztnál a QuickT támogatás-aktivált hitelesítő adatokat ellenőriz egy kijelölt bérlői végpont előtt. Ez az eszközre kész nézet egyértelművé teszi a kizárólag szerverhívás útvonalát is.
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"}'A QuickT a hitelesítő adatok biztonságát a szerveroldali titkos tárolás köré szervezi. Az eszközre kész nézete nem hasonlít össze kliens csomag beágyazást. Nincsenek nyilvános naplók vagy tárolók, ez a végső ellenőrzés.
02
Hivatkozás feloldása
A Resolve művelet esetén a QuickT ellenőrzi a forrásfelismerést egy benyújtott URL formátumai előtt. Ez az eszközre kész nézet szintén egyértelművé teszi, hogy nincs kitalált kimenet.
POST
/v1/resolveHatály: megoldani| Mező | Típus | Kötelező | Leírás |
|---|---|---|---|
route_source | HTTPS URL | Igen. | Nyilvános vagy engedélyezett médiaoldal elemzése. |
tenant | karakterlánc | Nem. | Hozzárendelt bérlői domain. Általában elhagyható. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}A QuickT változatlanul rendezi a Formátumazonosítót a visszakapott érték köré. Az eszköz-kész nézete linkenkénti elérhetőséget hasonlít össze. Nincs tippelt minőségi címke, amely a végső ellenőrzés maradna.
03
Letöltési feladat létrehozása és követése
A Munka létrehozásának magyarázatához a QuickT elkülöníti az aszinkron előkészítést egy rövid HTTP-kéréstől. Egy eszközre kész nézet saját helyet ad a korlátozott munkavégzésnek.
POST
/v1/jobsHatály: munkahelyek| Mező | Típus | Kötelező | Leírás |
|---|---|---|---|
route_source | HTTPS URL | Igen. | Ugyanaz a normalizált forrás került benyújtásra megoldásra. |
route_format | karakterlánc | Igen. | Egy pontos azonosító a feloldási válaszból. |
tenant | karakterlánc | Nem. | Hozzárendelt bérlői domain. Általában elhagyható. |
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} ugyanazzal a kulccsal.| Állapot | Jelentése | Ügyfél akció |
|---|---|---|
queued | Felvétel a korlátozott várólistára. | Újra szavazás hátraléptetéssel. |
extracting | Forrás metaadatok vagy útvonal frissítése. | Folytasd a szavazás. |
processing | Letöltés, remuxing vagy egyesítés. | Kiszolgáló előrehaladásának megjelenítése. |
ready | Aláírt letöltés elérhető. | Küldje el az URL-t a felhasználónak. |
failed | Terminál strukturált hiba. | Olvasd el error_codeCsak akkor próbálkozzon újra, ha azt tanácsolják. |
expired | Az ideiglenes kimenetet eltávolították. | Hozzon létre egy új feladatot. |
curl https://quickt.io/v1/jobs/ROUTE_JOB \
-H "X-API-Key: $QUICKT_ROUTE_TOKEN"Az egy másodperces kezdeti várakozás a kiindulópont a Job lekérdezéséhez a QuickT eszközön. Egy eszköz-kész nézet ezután bemutatja a korlátozott visszalépést és elmagyarázza az ideiglenes aláírt kézbesítést.
04
Kiszámítható hibák
Hibaszerződés esetén a QuickT egy nem 2xx borítékkal kezd. Az eszköz-kész nézet ezt egy támogatási kérésazonosítóval párosítja, és kiszámítható klienskezeléssel zárul.
{
"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 | Tipikus jelentése | Akció |
|---|---|---|
| 400 | Érvénytelen URL, tartalom vagy nem elérhető formátum. | Javítsa a kérést. Oldja meg újra a formátumokért. |
| 401 | Hiányzó, érvénytelen, lejárt vagy rossz hatókörű kulcs. | Ellenőrizze a kiszolgálóoldali hitelesítő adatokat. |
| 403 | A bérlő vagy a forrás irányelve elutasította a kérést. | Ne kerülje meg a szabályzatot. Lépjen kapcsolatba a támogatással. |
| 404 | Ismeretlen vagy lejárt munka. | Ha szükséges, hozzon létre egy új feladatot. |
| 429 | Kérés vagy aktív feladat limit elérve. | Becsület retry_after_seconds. |
| 503 | Sor/kapacitás vagy upstream ideiglenesen nem elérhető. | Próbálja újra exponenciális visszalépéssel és jitterrel. |
05
Üzemeltetési szerződés
A QuickT jóváhagyáskor mobilkliens-korlátokat választ, így a készítői hálózatok és az API reagálók maradnak.
- Használjon idempotens alkalmazáslogikát, és soha ne indítson párhuzamos feladatokat ugyanahhoz a felhasználói kattintáshoz.
- A gyorsítótár oldja meg a metaadatokat röviden, de a aláírt letöltési URL-eket mindig lejártnak tekintse.
- Használjon korlátozott exponenciális visszalépést jitterrel
429,503és újrapróbálható hibák. - Csak nyilvános vagy olyan médiafájlokat dolgozzon fel, amelyekhez Ön jogosult hozzáférni, és ne kerülje meg a DRM-et és a hozzáférés-vezérlést.
- Tartsa meg a kérésazonosítókat és a feladatazonosítókat a privát működési naplókban. Ne naplózza szükségtelenül a beküldött URL-eket.
Sémához való hozzáférés esetén a QuickT aktiválást ellenőriz felfedezés előtt, majd hozzárendelt hitelesítés előtt. Ez az eszköz-kész nézet a dokumentált kérésformákat is egyértelművé teszi.
Aktiválás a támogatáson keresztül
Írja le a mobil élményt, a forgalmi várakozásokat és a szükséges alkotói hálózatokat. A QuickT ezeket az információkat használja az elemzés és a sorba állítási engedélyek hozzárendeléséhez, mielőtt egyszer felfedi a titkot.
Aktiválás kérése A kulcsok bérlői hatókörűek, visszavonhatók, és a Kapcsolatfelvételi űrlapon keresztül adhatóak ki. Névtelen parancsfájlok nem tudnak letöltő munkát végrehajtani.