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

በ downf.io የሚያደርጉ አውርዶችን ያንቀሳቅሱ

DownF እስከ አንድ ኦፕሬተር የተስማሚነት አጠቃቀም ጉዳይን እንዲገምጽ ድረስ API እንቅስቃሴን ያቆምበታል። እነዚህ ምሳሌዎች የተያዙትን ውል ይገልጻሉ፣ እውነተኛ መለያዎችና ብዛቶች ግን በድጋፍ እንቅስቃሴ ብቻ ይመጣሉ።

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

ፈጣን ጅምር

DownF የAPI አሰራር አካባቢን በድጋፍ ተነሳሽ ማረጋገጫዎች ይደርሳል። የተዛመደ እይታው የተመደበ ተከናዋች አካባቢን ይነጻጸራል። የአገልግሎት ብቻ የሆነ ጥሪ መንገድ የመጨረሻ ምርመራ ነው።

ዩአርኤልን አሳርፍhttps://downf.io

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

የደንበኛ መገለጫDownfBridge

የ API ስሪትv1

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

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

የማረጋገጫ ደህንነት በDownF ላይ የአገልጋይ አገልግሎት የሚያስቀምጥ ምስጢር ቁልፍ ከመቆየት ይጀምራል። ይህ የተስማሚነት እይታ ከዚያ በኋላ የደንበኛ ጭነት መያዣ አይደለም። የመጨረሻው እውነታ ማንኛውም ህዝብ መዝገቦች ወይም ማከማቻዎች አይኖሩም።

አገናኝን መፍታት

DownF የመፍትሄ እንቅስቃሴን በምንጭ ማወቅ ዙሪያ ያደርጋል። የመስማማት እይታው ከአንድ የተላከ ዩአርኤል ቅርጾችን ይነጻጸራል። ምንም የተፈጥሮ ውጤቶች አይቀሩም እና ይህ የመጨረሻ ምርመራ ነው።

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

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

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

ቅርጸ ቁጥር መለያ በDownF ላይ የተመለሰውን እርስዎ እንደማይቀየር ይጀምራል። ይህ የተዛመደ እይታ ከዚያ በኋላ በአንድ-አገናኝ አማራጭነትን ያቀርባል። የመጨረሻው እውነታ ምንም የተገመተ ጥራት መለኪያ አይኖረውም።

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

የሥራ ፈጠራ በ DownF ላይ ከ asynchronous ዝግጅት ጋር ይጀምራል. ቀጣዩ እይታ አጭር የ HTTP ጥያቄን ይሸፍናል. ገጹ የተገደበ የሰራተኛ አፈፃፀም ይታያል.

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

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

curl -X POST https://downf.io/v1/jobs \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"media_address":"https://www.youtube.com/watch?v=VIDEO_ID","output_ref":"18"}'

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

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

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

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

curl https://downf.io/v1/jobs/TRANSFER_REF \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN"

DownF ያለውን ተኳሃኝነት እይታ የሥራ መራጮች አንድ-ሁለተኛ የመጀመሪያ መጠበቅ ይመረምራል. እሱ capped backoff ቀጣይ ያሳያል እና ጊዜያዊ የተፈረመ አቅርቦት አያጠፋም.

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

DownF ለስህተት ውል ሶስት ተግባራዊ ነጥቦችን ያቀርባል። የመጀመሪያው ነጥብ አንድ ያልሆነ 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	ረድፍ / አቅም ወይም ወደላይ ወቅታዊ ያልሆነ።	በኤክስፖኔንሺያል ኋላ እና በጂተር እንደገና ይሞክሩ ፡፡

የአሠራር ውል

DownF የታሰበውን ደንበኛ ካስተዋለ በኋላ የመስማማት ምርመራዎቹን እና የላይኛው አቅራቢዎችን የተረጋጋ ሆኖ በመጠበቅ የጥያቄ ጣሪያን ያዘጋጃል ፡፡

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

DownF የስኬማ መዳረሻን ከመለያየት በፊት በእንቅስቃሴ ይደርሳል። የተስማሚነት እይታው የተመደበ ማረጋገጫ ይነጻል። የተሰነዘረ የጥያቄ አቀማመጦች የመጨረሻ ምርመራ ናቸው።

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

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

ምርቱን ይግለጹ፣ የወሩን ጥሪዎች ተንቀሳቃሽ ያድርጉ እና ሊተከለው የሚገባቸውን መድረኮች ዝርዝር ያዘጋጁ። DownF ድጋፍ ከአንድ ጊዜ የሚታይ መለያ እንዲሰጥ በፊት የሚያስፈልጉትን ክልሎች ያረጋግጣል ፣ የተቀመጠው ቅጂ ከሃሽ ብቻ ነው።

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