PRODUCTION REST API · v1

Wulite nbudata na YTSave

Dozie URL mgbasa ozi ọha, họrọ usoro ziri ezi, mepụta ọrụ asynchronous ma nye nsonaazụ e debanyere aha nye onye ọrụ gị. Pipeline mmepụta nke a na-achịkwa nke ọma na-enye saịtị YTSave ike.

YTSaveClientJSON n'elu HTTPSỌrụ AsynchronousAkwụkwọ ikike nwere oke

Malite ngwa ngwa

YTSave na-ahụ maka onye nnọchite API site n'ịmata akara nkwado nke arụpụtara mbụ. Ọ na-esochi ya na njedebe onye nwe ụlọ ọrụ nyere ma na-eme ka ụzọ oku sava naanị pụta ìhè.

URL onye nwe ụlọhttps://ytsave.app

NkwenyeX-API-Key: ys_live_…

Profailị onye ahịaYTSaveClient

Ụdị APIv1

# 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"}'

Iji kọwaa nchekwa Credential, YTSave na-ekewa nchekwa nzuzo nke sava n'akụkụ site na enweghị itinye ngwugwu onye ahịa. Ndekọ ihe akaebe anaghị enye ndekọ ọha ma ọ bụ ebe nchekwa nke ya.

Dozie njikọ

YTSave na-ahụ maka ọrụ Ndozi site na ịmata nchọpụta isi mmalite mbụ. Ọ na-esochi ya na usoro site na otu URL e nyefere ma anaghị echekwa mmepụta e kere eke na ngosipụta.

ZIPỤ/v1/resolveMpaghara: dozie

Ọhịa	Ụdị	Chọrọ	Nkọwa
`url`	HTTPS URL	Ee	Ihu nke mgbasa ozi ọha ma ọ bụ nke a kwadoro iji nyochaa.
`tenant`	eriri	Mba	Ebe obibi onye nwe ụlọ nyere. A na-ejikarị ya hapụ.

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

Iji kọwaa Njirimara usoro, YTSave na-ekewa uru a wepụtara na-enweghị mgbanwe site na nnweta kwa njikọ. Ihe ndekọ ihe akaebe anaghị enye akara mma a chere echiche ebe nke ya.

Mepụta ma soro ọrụ ibudata

Maka imepụta Ọrụ, YTSave na-amalite na nhazi asynchronous. Ihe ndekọ ihe akaebe ya na-ejikọta nke ahụ na arịrịọ HTTP dị mkpụmkpụ ma kwụsị na mmezu ọrụ onye ọrụ nwere oke.

ZIPỤ/v1/jobsOgo: ọrụ

Ọhịa	Ụdị	Chọrọ	Nkọwa
`url`	HTTPS URL	Ee	Isi mmalite a haziri nke ọma e nyefere iji dozie.
`format_id`	eriri	Ee	ID kpọmkwem sitere na nzaghachi ngwọta.
`tenant`	eriri	Mba	Ebe obibi onye nwe ụlọ nyere. A na-ejikarị ya hapụ.

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 EkwereChekwaa job_id.

2Ọnọdụ ajụjụ ọnụGET /v1/jobs/{job_id} na otu igodo ahụ.

3KwadebereMeghee URL nbudata nke e dere aka.

Ọnọdụ	Nkọwa	Omume onye ahịa
`queued`	E nyere gị ohere ịbanye na ndepụta a na-achịkwa.	Jụọ ajụjụ ọzọ na nkwụsịtụ.
`extracting`	Na-emelite metadata isi ma ọ bụ ụzọ.	Gaa n'ihu na-ajụ ajụjụ.
`processing`	Na-ebudata, na-emegharị ma ọ bụ na-ejikọta.	Gosi mmepe sava.
`ready`	Nbudata e dere aka dị.	Zipu URL ahụ nye onye ọrụ.
`failed`	Njehie nhazi ọdụ.	Gụọ `error_code`. Nwa ọzọ naanị mgbe e nyere ndụmọdụ.
`expired`	E wepụrụ mmepụta nke oge.	Mepụta ọrụ ọhụrụ.

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

YTSave na-eme ka nyocha ọrụ dị mfe ịgụ. Ibe ahụ na-amalite na ichere nkeji nkeji nkeji, na-aga na nkwụsị azụ nke nwere oke, ma na-ekwuputa nnyefe nwa oge nke e debanyere aha.

Njehie a pụrụ ịkọ

Maka nkwekọrịta njehie, YTSave na-enyocha otu mkpuchi na-abụghị 2xx tupu ID arịrịọ nkwado. Ihe ndekọ ihe akaebe a na-eme ka njikwa onye ahịa a na-atụ anya doo anya.

{
  "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	Nkọwa nkịtị	Omume
400	URL ezighi ezi, ahụ ma ọ bụ usoro adịghị.	Dozie arịrịọ ahụ. Meegharị maka usoro.
401	Igodo efu, ezighi ezi, agwụla ma ọ bụ nke nwere oke njikọ ezighi ezi.	Lelee ikike nke sava.
403	Ndị nwe ụlọ ma ọ bụ iwu isi iyi jụrụ arịrịọ ahụ.	Ejila iwu ahụ gafere. Kpọtụrụ nkwado.
404	Ọrụ amaghị ma ọ bụ nke agwụla oge.	Mepụta ọrụ ọhụrụ ma ọ bụrụ na ọ dị mkpa.
429	Arịrịọ ma ọ bụ oke ọrụ na-arụ ugbu a eruola.	Ugwu `retry_after_seconds`.
503	Ntụgharị/ike ma ọ bụ elu mmiri adịghị ugbu a.	Gbalịa ọzọ na mgbake mụbara na jitter.

Nkwekọrịta ọrụ

YTSave na-enye oke ọrụ na nkwado ọ bụla iji chebe onye na-eji API na ọrụ mgbasa ozi elu.

Jiri ụkpụrụ ngwa idempotent ma ghara ịmalite ọrụ abụọ maka otu pịa onye ọrụ.
Chekwaa metadata ngwọta obere oge, ma na-elekọta URL ibudata nke e debanyere aha ka ọ na-agwụ oge mgbe niile.
Jiri bounded exponential backoff nwere jitter maka 429, 503 na njehie a pụrụ imeghari.
Naanị mee usoro maka mgbasa ozi ọha ma ọ bụ mgbasa ozi ị nwere ikike ịnweta. A naghị agafe DRM na njikwa nnweta.
Debe ID arịrịọ na ID ọrụ na ndekọ arụmọrụ nkeonwe. Ekwela ka e dekọọ URL e zigara n'enweghị mkpa.

YTSave na-ahụ maka nnweta Schema site n'ịmata mbido tupu nyocha. Ọ na-esochi ya na nkwenye enyere ma na-edobe ụdị arịrịọ edere n'anya. Nkọwa OpenAPI

NKWADO NLEBA ANYA SITE NA OPERATOR

Rịọ igodo API gị

Dee onye na-eji API, ọnụ ọgụgụ arịrịọ kwa ọnwa ya na ihe achọrọ ikpo okwu kwadoro. YTSave na-enyocha ma idozi, izipu ọrụ ma ọ bụ abụọ kwesịrị ekwesị tupu ịnye igodo nke a hụrụ otu oge.

Arịrịọ nnweta API Igodo bụ nke onye nwe ụlọ ọrụ, enwere ike iwepụ ha ma e nyere ha site na fọm kọntaktị. A naghị ekwe ka scripts na-enweghị aha mee ọrụ nbudata.