https://quickt.ioИзграждане на изтегляния с QuickT
QuickT документира как мобилен клиент би комуникирал със услугата. Той не може да подаде продукционна работа, докато поддръжката не одобри дизайна и не активира ограничен достъп.
Бърз старт
За API хост, QuickT проверява активираните от поддръжката идентификационни данни преди определен крайна точка на наемател. Този преглед на устройството също изяснява пътя на повикване само към сървъра.
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 организира безопасността на идентификационните данни около съхранението на тайни от страна на сървъра. Неговият преглед, готов за устройство, не включва вграждане на клиентски пакет. Липсата на публични дневници или хранилища остава крайната проверка.
Разрешаване на връзка
За операция Resolve, QuickT проверява откриването на източника преди формати от един подаден URL. Този изглед, готов за устройство, също така ясно показва, че няма измислени изходи.
/v1/resolveОбхват: решаване| Поле | Тип | Задължително | Описание на продукта |
|---|---|---|---|
route_source | HTTPS адрес | Да | Публична или упълномощена медийна страница, която да анализира. |
tenant | низ | Не. | Присвоен домейн на наемателя. Обикновено се пропуска. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}QuickT организира идентификатор на формат около върнатата стойност без промяна. Неговият изглед, готов за устройството, сравнява наличността за всяка връзка. Няма предположен етикет за качество, който да остане като окончателна проверка.
Създаване и проследяване на задача за изтегляне
За да обясни създаването на задача, QuickT разделя асинхронната подготовка от кратката HTTP заявка. Прегледът за готово устройство дава на ограниченото изпълнение на работника собствено място.
/v1/jobsОбхват: работни места| Поле | Тип | Задължително | Описание на продукта |
|---|---|---|---|
route_source | HTTPS адрес | Да | Същият нормализиран източник, подаден за разрешаване. |
route_format | низ | Да | Точен идентификатор от отговора за разрешаване. |
tenant | низ | Не. | Присвоен домейн на наемателя. Обикновено се пропуска. |
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} със същия ключ.| Състояние | Значение | Действие на клиента |
|---|---|---|
queued | Допуснат до ограничената опашка. | Анкета отново с отстъпление. |
extracting | Обновяване на изходните метаданни или маршрут. | Продължете да гласувате. |
processing | Изтегляне, ремиксиране или сливане. | Показване на напредъка на сървъра. |
ready | Подписано изтегляне е налично. | Изпратете адреса на потребителя. |
failed | Терминална структурирана грешка. | Прочетете error_codeПовторете опита само когато ви бъде препоръчано. |
expired | Временният изход беше премахнат. | Създаване на нова работа. |
curl https://quickt.io/v1/jobs/ROUTE_JOB \
-H "X-API-Key: $QUICKT_ROUTE_TOKEN"Началното изчакване от една секунда е отправната точка за опресняване на задачите на QuickT. Прегледът, готов за устройството, след това представя ограничено отлагане и обяснява временно подписана доставка.
Предсказуеми грешки
За договор за грешки, QuickT започва с един конверт, който не е 2xx. Неговият преглед, готов за устройството, го съчетава с идентификатор на заявка за поддръжка и завършва с предвидимо обработване от клиента.
{
"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 | Типично значение | Действие |
|---|---|---|
| 400 | Невалиден адрес, тяло или недостъпен формат. | Коригирайте заявката. Решете отново за формати. |
| 401 | Липсва, невалиден, изтекъл или с грешен обхват ключ. | Проверете идентификационните данни от страна на сървъра. |
| 403 | Наемател или източник политика отхвърли искането. | Не заобикаляйте правилата. Свържете се с поддръжката. |
| 404 | Неизвестна или изтекла работа. | Създайте нова работа, ако е подходящо. |
| 429 | Достигане на ограничението за заявки или активни задачи. | Чест. retry_after_seconds. |
| 503 | Опашка/капацитет или нагоре по веригата временно недостъпни. | Опитайте отново с експоненциално отстъпление и трептене. |
Договор за експлоатация
QuickT избира ограничения за мобилни клиенти по време на одобрението, така че мрежите на създателите и API остават отзивчиви.
- Използвайте idempotent логика на приложението и никога не започват дублирани работни места за един и същ потребител клик.
- Кешът разрешава метаданните за кратко, но винаги третира подписаните адреси за изтегляне като изтичащи.
- Използвайте ограничен експоненциален отстъп с трептене за
429,503и повторяеми грешки. - Обработвайте само публични медии или медии, до които имате разрешение за достъп. DRM и контролите за достъп не се заобикалят.
- Съхранявайте идентификационните номера на заявките и идентификационните номера на задачите в частни оперативни регистрационни файлове.
За достъп до Схемата, QuickT проверява активирането преди изследване и преди зададена автентикация. Този преглед, готов за устройството, също прави ясни документираните форми на заявките.
Активиране чрез поддръжка
Опишете мобилното изживяване, очаквания трафик и мрежите на създателите, от които се нуждае. QuickT използва тази информация, за да присвои анализ и разрешения за опашка, преди да разкрие тайната веднъж.
Заявка за активиране Ключовете са с обхват на наемателя, отменяеми и издадени чрез формата за връзка.Анонимните скриптове не могат да изпълняват работа за изтегляне.