ПРОИЗВОЂЊА РЕСТ АПИ · в1

Preuzimanja izgradnje sa YTSave

Rešite javni URL medija, izaberite tačan format, kreirajte asinhroni zadatak i predajte potpisani rezultat svom korisniku. Isti ograničeni proizvodni proces pokreće vebsajt YTSave.

YTSaveClientЈСОН преко ХТТПС-аАсинхрони пословиОбимне акредитиве

Брзи почетак

YTSave rukuju API hostom prvo identifikujući akreditive aktivirane podrškom. Zatim sledi dodeljena krajnja tačka zakupca i održava putanju poziva samo za server u vidu.

УРЛ закупцаhttps://ytsave.app

АутентификацијаX-API-Key: ys_live_…

Профил клијентаYTSaveClient

Верзија АПИ-јаv1

# Available only after support activation
export YTSAVE_API_KEY="issued-after-review"

curl -X POST https://ytsave.app/v1/resolve \
  -H "X-API-Key: $YTSAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=VIDEO_ID"}'

Da bi objasnio bezbednost akreditiva, YTSave odvaja serversku tajnu pohranu od neuključivanja klijentskog paketa. Zapis dokaza ne dodeljuje mesto za javne dnevnike ili repozitorijume.

Решите везу

YTSaveрукује Решите операцију тако што ћете прво идентификовати откривање извора.Следе са форматима из једног поднетог УРЛ-а и не задржавају измишљене излазе у погледу.

ПОШТА/v1/resolveОпсег: решити

Поље	Тип	Обавезно	Опис
`url`	ХТТПС УРЛ	Да	Јавна или овлашћена медијска страница за анализу.
`tenant`	низ	Не.	Додељени домен закупца.Обично се изоставља.

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

Da bi objasnio identifikator formata, YTSave odvaja vraćenu vrednost nepromenjenu od dostupnosti po linku. Zapis dokaza ne dodeljuje mesto za pretpostavljenu oznaku kvaliteta.

Креирајте и пратите посао за преузимање

За Јовово стварање,YTSaveпочиње са асинхроном припремом.Његов доказни запис спаја то са кратким ХТТП захтевом и завршава се ограниченим извршењем радника.

ПОШТА/v1/jobsОбим: послови

Поље	Тип	Обавезно	Опис
`url`	ХТТПС УРЛ	Да	Исти нормализовани извор поднео да се реши.
`format_id`	низ	Да	Тачан ИД из одговора на решавање.
`tenant`	низ	Не.	Додељени домен закупца.Обично се изоставља.

curl -X POST https://ytsave.app/v1/jobs \
  -H "X-API-Key: $YTSAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=VIDEO_ID","format_id":"18"}'

1202 ПрихваћеноСачувајте job_id.

2Статус анкетеGET /v1/jobs/{job_id} истим кључем.

3СпреманОтворите потписан УРЛ за преузимање.

Статус	Значење	Радња клијента
`queued`	Примљен у ограничени ред.	Анкета поново са бекоффом.
`extracting`	Освежавање изворних метаподатака или руте.	Наставите са анкетирањем.
`processing`	Преузимање, ремуковање или спајање.	Прикажи напредак сервера.
`ready`	Потписано преузимање је доступно.	Пошаљите УРЛ кориснику.
`failed`	Терминал структурирана грешка.	Прочитај `error_code`.Поново покушајте само када се саветује.
`expired`	Привремени излаз је уклоњен.	Креирајте нови посао.

curl https://ytsave.app/v1/jobs/JOB_ID \
  -H "X-API-Key: $YTSAVE_API_KEY"

YTSaveчини да се анкетирање о Јоб-у лако скенира.Страница почиње са почетним чекањем од једне секунде, прелази на ограничено бекофф и јасно наводи привремену потписану испоруку.

Предвидљиве грешке

За Грешка уговор,YTSaveпроверава једну не-2хх коверту пре идентификатора захтева за подршку.Овај доказни запис такође чини јасним предвидљиво руковање клијентом.

{
  "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": "…"
}

ХТТП	Типично значење	Радња
400	Неважећи УРЛ, тело или недоступан формат.	Исправити захтев.Решите поново за формате.
401	Недостатак, неважећи, истекао или погрешан кључ.	Проверите акредитиве на страни сервера.
403	Станар или извор политика одбио захтев.	Немојте заобићи политику.Контактирајте подршку.
404	Непознати или истекли посао.	Креирајте нови посао ако је то прикладно.
429	Досегнута граница захтева или активних задатака.	Почасни `retry_after_seconds`.
503	Ред / капацитет или узводно привремено недоступан.	Поново покушајте са експоненцијалним бекоффом и џитером.

Оперативни уговор

YTSaveиздаје оперативну квоту са сваким одобрењем како би заштитио АПИ потрошача и успутне медијске услуге.

Користите идемпотентну логику апликације и никада не покрените дупликат послова за исти кориснички клик.
Кеш решава метаподатке кратко, али увек третира потписане УРЛ-ове за преузимање као истекао.
Користите ограничено експоненцијално бекофф са џитером за 429, 503 и поновљиве грешке.
Обрађивати само јавне медије или медије којима сте овлашћени да приступите. DRM и контроле приступа нису заобиђени.
Чувајте идентификаторе захтева и идентификаторе послова у приватним оперативним дневницима.Немојте непотребно евидентирати поднесене УРЛ-ове.

YTSave upravlja pristupom šemi tako što prvo identifikuje aktivaciju pre istraživanja. Slede dodeljena autentifikacija i održavanje dokumentovanih oblika zahteva na vidiku. Референца за ОпенАПИ

ПРИСТАП КОЈИ ПРЕИЗИМА ОПЕРАТОР

Захтевајте свој АПИ кључ

Dokumentujte korisnika API-ja, njegovu procenu mesečnih zahteva i podržane zahteve platforme. YTSave proverava da li je opravdano rešavanje, podnošenje zadatka ili oboje pre izdavanja ključa koji je jednom bio vidljiv.

Захтев за АПИ приступ Кључеви су обухваћени закупцем, опозиви и издају се кроз формулар за контакт.Анонимне скрипте не могу извршити рад преузимача.