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

ከEasyT ጋር አውርዶችን ሠርተው

ይህ የEasyT ማጠቃለያ እንደ እንቅስቃሴ ያልሆነ የማስተናገድ መምሪያ ነው። የምርት መዳረሻ ከድጋፍ አገዛዝ በኋላ ብቻ ይጀምራል እና ደንበኞቹን ይፈቅዳል እና ገደቦችን ይሰጣል።

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

ፈጣን ጅምር

API አሰራር በEasyT ላይ ከድጋፍ ተነሳ የተከፈተ መለያ ጋር ይጀምራል። ይህ መምሪያ ምርመራ ከዚያ በኋላ የተመደበ የተከራይ መጨረሻ ነጥብ ያቀርባል። የመጨረሻው እውነታ የአገልጋይ ብቻ የሚደረግ ጥሪ መንገድ ነው።

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

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

የደንበኛ መገለጫEasytWorkspace

የ API ስሪትv1

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

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

EasyT ውስጥ፣ የአገልጋይ አገልግሎት የሚሰጥ ምስጢር ማከማቻ በመነሻ ሲነገር የማረጋገጫ ደህንነት ይመራል። ያለ ደንበኛ ጭነት አስቀምጦ የማይኖር እና ለህዝብ መዝገቦች ወይም ማከማቻዎች አይኖርም።

አገናኝን መፍታት

መፍትሄ እንቅስቃሴ በEasyT ላይ ከምንጭ ማወቅ ጋር ይጀምራል። ይህ መመሪያ ያለው ምርመራ ከአንድ የተሰጠ URL ቅርጸ ቅርጾችን ከፍ ያደርጋል። የመጨረሻው እውነታ ምንም የተፈጥሮ ውጤቶች አልነበሩም።

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

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

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

EasyT ውስጥ የተመለሰው እሴት ለመለያ ቅርጸ ቁምፊ ሲታሰር በመጀመሪያ ይቀርባል። ይህ የተመራ ምርመራ በአንድ-አገናኝ አማካይነት እንደሚገኝ ይከተላል እና በምንም ጥራት መለያ አይገምትም በማለት ይዝጋል።

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

የተዘጋጀ አሰራር በEasyT ላይ ለሥራ ፍጠር የመነሻ ነጥብ ነው። አንድ መምሪያ ምርመራ ከዚያ በኋላ አጭር HTTP ጥያቄ ያቀርባል እና የተገደበ ሰራተኛ እንቅስቃሴን ያስረዳል።

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

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

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

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

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

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

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

curl https://easyt.io/v1/jobs/WORKSPACE_JOB \
  -H "X-API-Key: $EASYT_WORKSPACE_TOKEN"

ለስራ ምርመራ ሲሆን EasyT በአንደኛ ሰከንድ የመጀመሪያ ቆይታ ይጀምራል። የተመራ ምርመራው ከተገደበ መቆለፊያ ጋር ተያይዞ ይጨርሳል እና በጊዜያዊ ፊርማ የተሰጠ እንደማድረስ ይወጣል።

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

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

የአሠራር ውል

EasyT በእይታ ላይ የሚሰጥ እንደሆነ የስራ ፈቃድ ይምረጣል፣ የመተግበሪያውን ፍላጎቶች ከአቅራቢው ጤና ጋር በመስተካከል።

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

Schema መዳረሻ በEasyT ላይ ከንቁ ማስተካከያ በፊት ይጀምራል። ይህ ተመራማሪ ምርመራ ከዚያ በኋላ የተመደበ ማረጋገጫ ያቀርባል። የመጨረሻው እውነታ የተጠየቀ እንደቅርጸ ተሞክሮ ይታወቃል።

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

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

በእንቅስቃሴ ማስታወቂያ ውስጥ የደንበኛውን ዓላማ፣ የተጠበቀውን ወርሃዊ ሥራ መጠን እና የተጠየቁትን ኔትወሮች አካትተው ያስገቡ። EasyT ከዚያ በፊት ችግኝነትን እና የሥራ አካባቢዎችን በትክክል ሊምረጥ እና አንድ እይታ ያለውን ምስጢር ሊያበረክት ይችላል።

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