ҮЙЛДВЭРИЙН REST API · v1

YTSave ашиглан таталтыг бүрдүүлэх

Олон нийтийн медиа URL-г шийдэж, яг тохирох форматыг сонгож, асинхрон ажлыг үүсгэж, гарын үсэгтэй үр дүнг хэрэглэгчдээ дамжуул. Ижил хязгаарлагдмал үйлдвэрлэлийн шугам нь YTSave вэбсайтыг ажиллуулдаг.

YTSaveClientHTTPS дээрх JSONАсинхрон ажлуудХязгаарлагдмал эрхийн бичиг

Хурдан эхлүүлэх

YTSave нь API хостыг дэмжлэг идэвхжсэн гэрчилгээг эхлээд тодорхойлсноор удирддаг. Үүний дараа томилогдсон түрээслэгчийн төгсгөлийн цэгийг дагаж, зөвхөн серверийн дуудлагын замыг харагдуулдаг.

Түрээслэгчийн URLhttps://ytsave.app

НэвтрэлтX-API-Key: ys_live_…

Хэрэглэгчийн профайлYTSaveClient

API хувилбар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"}'

Нууцлалын аюулгүй байдлыг тайлбарлахдаа YTSave сервер талын нууц хадгалалтыг хэрэглэгчийн багцад оруулахгүйгээр тусгаарладаг. Нотлох баримтын бүртгэл нь олон нийтийн бүртгэл эсвэл агуулахад өөрийн байр суурийг олгодоггүй.

Холбоосыг шийдвэрлэх

YTSave Resolve үйлдлийг эхлээд эх үүсвэрийн илрүүлэлтээр гүйцэтгэдэг. Дараа нь нэг URL-аас ирсэн форматуудыг дагаж, зохиомол гаралтыг харагдацад оруулдаггүй.

POST/v1/resolveХүрээ: шийдвэрлэх

Талбар	Төрөл	Шаардлагатай	Тайлбар
`url`	HTTPS URL	Тийм	Шинжилгээ хийх нийтийн эсвэл зөвшөөрөгдсөн медиа хуудас
`tenant`	мөр	Үгүй	Тодорхойлогдсон түрээслэгчийн домэйн. Ихэвчлэн орхигддог.

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

Форматын танигчийг тайлбарлахдаа, YTSave буцаасан утгыг холбоос тус бүрийн боломжтой байдлаас өөрчлөлтгүйгээр тусгаарладаг. Нотлох баримтын бичлэг нь таамагласан чанарын шошгыг өөрийн байр эзлүүлэхгүй.

Татаж авах ажлыг үүсгэж дагах

Ажлын үүсгэлтийн хувьд YTSave асинхрон бэлтгэлээс эхэлдэг. Түүний баримт нотолгооны бүртгэл нь үүнийг богино HTTP хүсэлттэй хослуулж, хязгаарлагдмал ажилтан гүйцэтгэлээр төгсдөг.

POST/v1/jobsХамрах хүрээ: ажлууд

Талбар	Төрөл	Шаардлагатай	Тайлбар
`url`	HTTPS URL	Тийм	Шийдвэрлэхэд зориулсан ижил хэвийн эх сурвалж илгээгдсэн.
`format_id`	мөр	Тийм	Тодорхой ID-г resolve хариултаас авна.
`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БэлэнГарын үсэгтэй татах URL-ийг нээнэ үү.

Төлөв	Утга	Хэрэглэгчийн үйлдэл
`queued`	Хязгаарлагдмал дараалалд орсон.	Буцах хугацаатай дахин санал асуулга явуулах.
`extracting`	Эх үүсвэрийн мета өгөгдөл эсвэл маршрутыг шинэчилж байна.	Сонголтыг үргэлжлүүлнэ.
`processing`	Татаж авах, дахин холих эсвэл нэгтгэх.	Серверийн явцыг харуулах.
`ready`	Гарын үсэгтэй татах боломжтой.	Хэрэглэгчид URL илгээх.
`failed`	Терминал бүтэцтэй алдаа.	Унших `error_code`. Зөвхөн зөвлөгөө авсан үед дахин оролдоно уу.
`expired`	Түр зуурын гаралт устгагдсан.	Шинэ ажлын байр үүсгэх.

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

YTSave ажлын шалгалтыг амархан сканнердах боломжтой болгодог. Хуудас нь нэг секундийн анхны хүлээлтээр эхэлж, хязгаарлагдмал хойшлуулалтад шилжиж, түр гарын үсэгтэй хүргэлтийг тодорхой заадаг.

Тодорхой алдаанууд

Алдааны гэрээний хувьд, YTSave дэмжлэгийн хүсэлтийн ID-ээс өмнө нэг 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	Буруу URL, бие эсвэл боломжгүй формат.	Хүсэлтийг засах. Форматуудыг дахин шийдвэрлэх.
401	Түлхүүр олдсонгүй, буруу, хугацаа нь дууссан эсвэл зөвшөөрөгдөөгүй хүрээтэй түлхүүр.	Сервер талын баталгаажуулалтыг шалгана уу.
403	Түрээслэгч эсвэл эх үүсвэрийн бодлого хүсэлтийг татгалзав.	Бодлогыг зөрчихгүй байх. Дэмжлэгтэй холбогдоно уу.
404	Тодорхойгүй эсвэл хугацаа дууссан ажил.	Хэрэв тохиромжтой бол шинэ ажлыг үүсгээрэй.
429	Хүсэлт эсвэл идэвхтэй ажлын хязгаар хүрсэн.	Хүндэтгэл `retry_after_seconds`.
503	Элсэх дараалал/багтаамж эсвэл дээд урсгал түр хугацаагаар ашиглах боломжгүй байна.	Экспоненциал хойшлуулга ба хэлбэлзэлтэйгээр дахин оролдоно уу.

Үйл ажиллагааны гэрээ

YTSave нь API хэрэглэгч болон дээд медиа үйлчилгээний аюулгүй байдлыг хангах үүднээс зөвшөөрөл бүрт үйл ажиллагааны хязгаар тогтоодог.

Идэмпотент програмын логикыг ашиглаж, нэг хэрэглэгчийн товшилтод зориулан давхардсан ажлыг эхлүүлэхгүй байх.
Кэш шийдвэрлэх метадатыг түр хугацаанд хадгална, гэхдээ гарын үсэгтэй татаж авах URL-уудыг үргэлж хугацаа дууссан гэж үзнэ үү.
Jitter-тэй хязгаарлагдмал экспоненциал буцаалт ашиглах 429, 503 мөн дахин оролдох боломжтой алдаанууд.
Зөвхөн олон нийтэд зориулсан медиа эсвэл таны эрхтэй хандах боломжтой медиа материалыг боловсруулна. DRM болон хандалтын хяналтыг тойрч гарахгүй.
Хүсэлт ID болон ажлын ID-үүдийг хувийн үйл ажиллагааны бүртгэлд хадгал. Илгээсэн URL-үүдийг шаардлагагүйгээр бүртгэж болохгүй.

YTSave нь Schema хандалтыг эхлээд идэвхжүүлэлтийг тодорхойлсноор удирддаг. Дараа нь олгогдсон баталгаажуулалтыг дагаж, хүсэлтийн баримтжуулсан хэлбэрүүдийг харагдацад хадгалдаг. OpenAPI лавлагаа

ҮЙЛДВЭРЛЭГЧИЙН ШАЛГАСАН НЭВТРЭЛТ

API түлхүүрээ хүсэх

API хэрэглэгч, сарын хүсэлтийн тооцоо болон дэмжигдсэн платформын шаардлагыг баримтжуулна. YTSave нь шийдвэрлэх, ажлын илгээх эсвэл аль аль нь зөв эсэхийг нэг удаа харагдах түлхүүр олгохоос өмнө шалгадаг.

API хандалтыг хүсэх Түлхүүрүүд нь түрээслэгчийн хүрээнд хязгаарлагдсан, цуцлах боломжтой бөгөөд Холбоо барих маягтаар олгогддог. Нэргүй скриптүүд татагчийн ажлыг гүйцэтгэж чадахгүй.