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

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

EasyF በቅድሚያ በተጠቃሚዎች ስራ ላይ ሊገምቱ የሚችሉበትን ቅርጸ ተግባር ያሳያል። ከሕይወት ቁልፍ እና አጠቃቀም ገደብ ከሚኖሩ በፊት የድጋፍ ግምገማ እንደገና ያስፈልጋል።

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

ፈጣን ጅምር

API አሰራርን ለማብራር፣ EasyF የድጋፍ ተነሳሽ ማረጋገጫዎችን ከተመደበ ተከራካሪ መግቢያ አገናኝ ያለው ይለያያል። የቀላል ቋንቋ ስራ ሂደት ለአገልጋይ ብቻ የሚደረግ ጥሪ መንገድ ራሱን ቦታ ይሰጣል።

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

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

የደንበኛ መገለጫEasyfClient

የ API ስሪትv1

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

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

የማረጋገጫ ደህንነት በEasyF ላይ ከአገልጋይ ጎን የተሰየመ ምስጢራዊ ማከማቻ ይጀምራል። ቀጣዩ እይታ የደንበኛ ጭነት አልተካተተም ይላል። ገፁ ህዝብ መዝገቦች ወይም ማከማቻዎች አይታዩም።

አገናኝን መፍታት

Resolve እንቅስቃሴን ለማብራር፣ EasyF የምንጭ መለያየትን ከቅርጸ ቅርጾች ከአንድ የተላከ ዩአርኤል ይለያል። ቀላል ቋንቋ ያለው ስራ ሂደት ምንም የተፈጥሮ ውጤቶች ለራሱ ቦታ አይሰጥም።

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

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

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

የቅርጸ ቅኔ መለያ በEasyF ላይ የተመለሰውን እሴት በማስቀመጥ ይጀምራል። ቀጣዩ እይታ በአንድ-አገናኝ አማራጭነት ይሰጣል። ገፁ የተገመተ የጥራት መለያ አይታይም።

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

EasyF ለስራ ፍጠራ ሶስት ተግባራዊ ነጥቦችን ያቀርባል። መጀመሪያ የተያያዘ አዘጋጅት ይመጣል። ቀላል ቋንቋ የስራ ሂደት ከዚያ በኋላ አጭር የHTTP ጥያቄ ይሸፍናል። መጨረሻው ነገር የተገደበ የሰራተኛ እንቅስቃሴ ነው።

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

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

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

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

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

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

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

curl https://easyf.app/v1/jobs/DELIVERY_ID \
  -H "X-API-Key: $EASYF_SERVICE_KEY"

EasyF ስራ ምርመራን በአንድ ሰከንድ የመጀመሪያ ቆይታ በኋላ በተገደበ መከላከያ ይቀበላል። በግልጽ ቋንቋ የሚሰራው ሂደት ጊዜያዊ የተፈረሰ አቅርቦትን በግልጽ ሁኔታ ይጠብቃል።

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

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

የአሠራር ውል

EasyF ሊተነበይ የሚችል የተመራ የስራ ፍሰት ለመጠበቅ ከእያንዳንዱ ከተፈቀደው ምርት ጋር ተግባራዊ የአጠቃቀም ገደቦችን ይስማማል።

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

ስኬማ መዳረሻን ለማብራር፣ EasyF ከተመደበ ማረጋገጫ በፊት እንቅስቃሴን ያስተናግዳል። የቀላል ቋንቋ ስራ ሂደት የተሰኘ ጥያቄ አቀማመጦችን ለራሱ ቦታ ይሰጣል።

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

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

EasyF ምን እንደምታደርጉ እና እንዴት ብዙ ጊዜ API እንደሚያጥራ እና የሚገኙት አቅራቢዎች ማን እንደሆኑ ይነግሩ። ግምገማው የተፈቀደውን እንቅስቃሴ ይወስናል፣ ከዚያም አንድ ጊዜ የሚያሳይ ማረጋገጫ ይገልጻል እና የደህንነቱን አጭር አሳይ ብቻ ሲቀርብ ይቆይ።

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