ቅድመ እይታ ብቻ — ማግበር ያስፈልጋል

ከ QuickDL ጋር ማውረዶችን ይገንቡ

QuickDL ገንቢዎች ከማነቃቃቱ በፊት የተጣጣመውን የጥያቄ ሞዴል እንዲመረምሩ ያስችላቸዋል ድጋፍ አንድ የግል ቁልፍ እና ኮታ ሊጠቀሙበት ከሚችሉበት በፊት ምርቱን ማረጋገጥ አለበት ፡፡

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

ፈጣን ጅምር

በ QuickDL ውስጥ, ድጋፍ-የተሰራጩ ማረጋገጫዎች የኤፒአይ አስተናጋጅ ሲገልጹ በመጀመሪያ ይመጣሉ. ያ ኮምፕዩተር ጠቀሜታ ከተመደበው የኪራይ መጨረሻ ጋር ይከተላል እና በአገልጋይ-ነፃ ጥሪ መንገድ ላይ ይዘጋል.

ዩአርኤልን አሳርፍhttps://quickdl.app

ማረጋገጫX-API-Key: pending_activation_…

የደንበኛ መገለጫQuickDlJobs

የ API ስሪትv1

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

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

QuickDL የማረጋገጫ ደህንነትን በመጀመሪያ የአገልጋይ አገልግሎት የሚያስቀምጥ ምስጢር ማከማቻ በመለያየት ይከታተላል። ከዚያ በኋላ የደንበኛ ጭነት አልተካተተም እና ህዝብ መዝገቦች ወይም ማከማቻዎች አይታዩም።

አገናኝን መፍታት

በQuickDL ውስጥ፣ ምንጭ መለያየት በResolve እንቅስቃሴ ሲተረዳ የመጀመሪያ ነው። ያ አጭር አገልግሎት ከአንድ የተላከ URL ቅርጸ ተከታታይ ተከትሎ ምንም የተፈጥሮ ውጤት አያስቀምጥም።

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

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

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

QuickDL ቅርጸ ቁጥር መለያየትን በመጀመሪያ የተመለሰውን እሴት ሳይለዋወጥ በመለያየት ያስተናግዳል። ከዚያም በአንድ-አገናኝ አማካይነት እንደሚገኝ ይከተላል እና ምንም የተገምተው የጥራት መለያ አይታይም።

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

የ QuickDL ውስን ጠቀሜታ ለ Job መፍጠር asynchronous ዝግጅት ይመረምራል. ቀጣዩን አጭር የ HTTP ጥያቄ ያሳያል እና የተገደበ የሰራተኛ አፈፃፀም አይሸፍንም.

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

መስክ	ዓይነት፦	አስፈላጊ	መግለጫ የለም
`public_link`	የHTTPS ዩአርኤል	አዎ	ለመፍታት የቀረበው ተመሳሳይ መደበኛ ምንጭ።
`download_option`	ሐረግ	አዎ	ከፈታ መልስ ትክክለኛ መታወቂያ።
`tenant`	ሐረግ	አዎ	የተመደበው የኪራይ ሰጪ ጎራ።በተለምዶ ችላ ይባላል ፡፡

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

1202 ተቀባይነት አግኝቷልአስቀምጥ quick_job.

2የምርጫ ሁኔታGET /v1/jobs/{quick_job} በተመሳሳይ ቁልፍ።

3ዝግጁየተፈረመውን የማውረድ ዩአርኤል ይክፈቱ።

ሁኔታ፦yes	ትርጉም	የደንበኛ እርምጃ
`queued`	ወደ የተገደበው ሰልፍ ተቀባይነት አግኝቷል ፡፡	ዳግም ከኋላ ኋላ ጋር ድምፅ ይስጡ ፡፡
`extracting`	ምንጭ ሜታዳታ ወይም መንገድን ማደስ ፡፡	መራጩን ይቀጥሉ ፡፡
`processing`	ማውረድ ፣ ሪሙክስ ወይም ማዋሃድ ፡፡	የአገልጋይ እድገትን ያሳዩ።
`ready`	የተፈረመ ማውረድ ይገኛል ፡፡	ዩአርኤልን ለተጠቃሚው ይላኩ ፡፡
`failed`	የተርሚናል የተዋቀረ ስህተት ፡፡	አንብብ `error_code`. በሚያሳስቡበት ጊዜ ብቻ እንደገና ይሞክሩ ፡፡
`expired`	ጊዜያዊ ውጤት ተጣለ ፡፡	አዲስ ሥራ ይፍጠሩ.

curl https://quickdl.app/v1/jobs/QUICK_JOB \
  -H "X-API-Key: $QUICKDL_JOB_KEY"

QuickDL ስለ ስራ ምርጫ ሶስት ተግባራዊ ነጥቦችን ያቀርባል። የመጀመሪያው ነጥብ አንደኛ ሰከንድ መጠባበቂያ ነው። ከዚያ በኋላ አጭር አገልግሎት የተገደበ ተመላላሽ እንዲሆን ይሰጣል። የመጨረሻው ነጥብ ጊዜያዊ የተፈረሰ እንደሆነ እንዲደርስ ነው።

ሊተነበዩ የሚችሉ ስህተቶች

QuickDL በአንድ ያልሆነ የ 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	ረድፍ / አቅም ወይም ወደላይ ወቅታዊ ያልሆነ።	በኤክስፖኔንሺያል ኋላ እና በጂተር እንደገና ይሞክሩ ፡፡

የአሠራር ውል

QuickDL የመነሻ አገልግሎቶችን ሳይደናቀፍ ውህደቱን የሚደግፍ ጠንካራ ፣ ለደንበኛ የተወሰነ ኮታ ይሰጣል ፡፡

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

በ QuickDL ውስጥ, የ Schema መዳረሻን ሲያስረዳ ከማጥናት በፊት ማነቃቃት በመጀመሪያ ይመጣል. ያ ኮምፕዩተር ጠቀሜታ ከተመደበው ማረጋገጫ ጋር ይከተላል እና በጽሑፍ በተደገፉ የጥያቄ ቅርጾች ላይ ይዘጋል.

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

በመደገፍ በኩል ያነቃቁ

QuickDL ከተያያዙ ስም፣ ተስፋ ያለው ወርሃዊ መጠን እና የሚያስፈልጉ ምንጮች ጋር ያቀርባል። አገልጋዩ የሚያከናውን እንቅስቃሴዎችን ያስለቅ እና እርግጠኛ የሆነ አንድ ጊዜ ቁልፍ እንዲፈጥር ያደርጋል።

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