የምርት REST API · v1

በYTSave የሚሰሩ አውርዶች

የህዝብ ሚዲያ ዩአርኤልን ይፍቱ ፣ ትክክለኛ ቅርጸት ይምረጡ ፣ አሲምሮክ ሥራን ይፍጠሩ እና የተፈረመውን ውጤት ለተጠቃሚዎ ያስተላልፉ ፡፡ ተመሳሳይ የተገደበ የምርት ቧንቧ መስመር የ YTSave ድር ጣቢያን ኃይል ይሰጣል ፡፡

YTSaveClientበኤችቲቲፒኤስ ላይ ጄኤስኦኤንያልተመጣጠነ ስራዎችየተሰነዘሩ ማረጋገጫዎች

ፈጣን ጅምር

YTSave ኤፒአይ ሆስትን በመጀመሪያ የድጋፍ ተነሳሽ ማረጋገጫዎችን በመለየት ያስተካክላል። ከዚያም የተመደበ ተነሳሽ አገልግሎት አድራሻ ይከተላል እና አገልግሎት-ብቻ የሚደረግ ጥሪ መንገድ በእይታ ላይ ይጠብቃል።

ዩአርኤልን አሳርፍhttps://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 እንቅስቃሴ በመጀመሪያ የምንጭ ምልክትን ይለያያል። ከአንድ የተሰጠ ዩአርኤል ቅርጸ ቁምፊዎችን ይከተላል እና ምንም የተፈጠረ ውጤት አይታይም።

መላክ/v1/resolveስፋት: መፍታት

መስክ	ዓይነት፦	አስፈላጊ	መግለጫ የለም
`url`	የHTTPS ዩአርኤል	አዎ	ለመተንተን የህዝብ ወይም የተፈቀደ ሚዲያ ገጽ።
`tenant`	ሐረግ	አዎ	የተመደበው የኪራይ ሰጪ ጎራ።በተለምዶ ችላ ይባላል ፡፡

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

ለቅርጸ ቅርጸ መለያየት ለማብራር፣ YTSave የተመለሰውን እሴት ከእያንዳንዱ አገናኝ አማራጭ በማይለዋወጥ ይለያል። አንድ ማስረጃ መዝግብ የተገመተ የጥራት መለያ ራሱን ቦታ አያስገባም።

የማውረድ ሥራን ይፍጠሩ እና ይከተሉ

ለስራ ፍጠር, YTSave በተወሰነ የማይተኛ አዘጋጅት ይጀምራል። የእርሱ ማስረጃ መዝገብ ከአንደኛው አጭር HTTP ጥያቄ ጋር ተያይዞ በተገደበ የሰራተኛ እንቅስቃሴ ይጨርሳል።

መላክ/v1/jobsስፋት: ሥራዎች

መስክ	ዓይነት፦	አስፈላጊ	መግለጫ የለም
`url`	የHTTPS ዩአርኤል	አዎ	ለመፍታት የቀረበው ተመሳሳይ መደበኛ ምንጭ።
`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ዝግጁየተፈረመውን የማውረድ ዩአርኤል ይክፈቱ።

ሁኔታ፦yes	ትርጉም	የደንበኛ እርምጃ
`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 ከድጋፍ ጥያቄ መለያ በፊት አንድ ያልሆነ 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": "…"
}

ኤችቲቲፒ	የተለመደ ትርጉም	አንቀጽ
400	የተሳሳተ ዩአርኤል ፣ አካል ወይም የማይገኝ ቅርጸት ፡፡	ጥያቄውን ያስተካክሉ.ለቅርጸቶች እንደገና ይፍቱ.
401	ጠፍቷል ፣ ዋጋ የለውም ፣ ጊዜው ያለፈበት ወይም የተሳሳተ-ስፋት ቁልፍ።	የአገልጋይ-ጎን ማረጋገጫውን ይፈትሹ።
403	ተራኪ ወይም ምንጭ ፖሊሲ ጥያቄውን ተቀበለ.	ፖሊሲውን አያቋርጡ. ድጋፍን ያነጋግሩ.
404	ያልታወቀ ወይም ጊዜው ያለፈበት ሥራ።	ተገቢ ከሆነ አዲስ ሥራ ይፍጠሩ ፡፡
429	ጥያቄ ወይም ንቁ-ሥራ ገደብ ደርሷል.	ክብር `retry_after_seconds`.
503	ረድፍ / አቅም ወይም ወደላይ ወቅታዊ ያልሆነ።	በኤክስፖኔንሺያል ኋላ እና በጂተር እንደገና ይሞክሩ ፡፡

የአሠራር ውል

የኤፒአይ ሸማች እና የላይኛው ሚዲያ አገልግሎቶችን ለመጠበቅ YTSave ከእያንዳንዱ ማጽደቅ ጋር የአሠራር ኮታ ያወጣል ፡፡

idempotent የመተግበሪያ ሎጂክ ይጠቀሙ እና ለተመሳሳይ ተጠቃሚ ጠቅታ ማንኛውንም ተመሳሳይ ሥራዎች በጭራሽ አይጀምሩ ፡፡
ካሽ ሜታዳታ በአጭሩ ይፍቱ ፣ ግን ሁል ጊዜ የተፈረሙ የወረዱ ዩአርኤሎችን እንደ ጊዜ ያለፈባቸው ይያዙ ፡፡
ለ ጂተር ጋር የተገደበ ኤክስፖንሽን ኋላ ቀር ይጠቀሙ 429, 503 እና እንደገና ሊሞከሩ የሚችሉ ስህተቶች።
ለማግኘት ፈቃድ የተሰጠዎትን የህዝብ ሚዲያ ወይም ሚዲያ ብቻ ያከናውኑ።የዲአርኤም እና የመዳረሻ መቆጣጠሪያዎች አይተላለፉም።
የጥያቄ መታወቂያዎችን እና የሥራ መታወቂያዎችን በግል ኦፕሬቲንግ መዝገቦች ውስጥ ያቆዩ ፡፡የተላኩትን ዩአርኤሎች ያለአግባብ አይመዝገቡ ፡፡

YTSave የስኬማ መዳረሻን በመለያየት እንደ መነሻ እንዲሁም በመምረም ይወስዳል። ከዚያም የተመደበ ማረጋገጫ ይከተላል እና የተደረገ ጥያቄ ቅርጾችን በእይታ ይጠብቃል። የኦፕንኤፒአይ ማጣቀሻ

በአፕሬተር የተሻሻለ መዳረሻ

የእርስዎን API ቁልፍ ይጠይቁ

የAPI ተጠቃሚውን፣ ወርሃዊ ጥያቄ ግምትና የደጋፊ መድረኮችን መለያየት ያስፈልጋል። YTSave ከአንድ ጊዜ ታይ የሚሆን ቁልፍ ከማስተላለፊያ በፊት መፍትሄ፣ ስራ ማስገባት ወይም ሁለቱም እንደሚገባ ይገምታል።

የ API መዳረሻን ይጠይቁ ቁልፎች በኪራይ ሰጪዎች የተወሰኑ ፣ ሊሰረዙ የሚችሉ እና በኩል የሚሰጡ ናቸው የግንኙነት ቅጽ.ያልታወቁ ስክሪፕቶች የወረዱትን ሥራ ማከናወን አይችሉም ፡፡