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

በInsts ውስጥ ያዘጋጁ አውርዶች

በታች ያለው Insts የስራ ጣቢያ ለተጠቃሚ የሚመጣ ሰነድ ነው። የኦፕሬተር ግምገማ ከማንኛውም የሚፈፀም ማረጋገጫ ወይም የጥሪ ፈቃድ በፊት ይኖራል።

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

ፈጣን ጅምር

API ማስተናገድ በ support-activated ማረጋገጫዎች በ Insts ይጀምራል። ቀጣዩ እይታ የተመደበ ተከራካሪ አካባቢን ይሸፍናል። ገፁ የአገልጋይ-ብቻ ጥሪ መንገድ እየታየ ይቆያል።

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

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

የደንበኛ መገለጫInstsConnect

የ API ስሪትv1

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

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

በInsts ላይ የማስረጃ ደህንነት መነሻ ነው የአገልጋይ አገልግሎት የሚሰደድ ምስጢር ማከማቻ። የምርመራ ቤንች ከዚያ በኋላ የደንበኛ ጭነት አስቀምጦ አይታይም እና ሕዝብ መዝገቦች ወይም ማከማቻዎች አያስረድብም።

አገናኝን መፍታት

መፍትሄ እንቅስቃሴ በInsts ላይ የምንጭ ማወቅ ከመጀመሪያ ይጀምራል። ቀጣዩ እይታ ከአንድ የተሰጠ ዩአርኤል ቅርጸ ቅርጸ ተለዋዋጮችን ይያያል። ገፁ ምንም የተፈጥሮ ውጤቶችን አያሳይም።

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

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

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

የተመለሰው ዋጋ ያልተለወጠ በInsts ላይ የቅርጸ ቁምፊ መለያ መነሻ ነው። አንድ ምርመራ ጣቢያ በአገናኝ ላይ ያለውን እንደሚገኝ ያሳያል እና የተገመተ የጥራት መለያ አይኖርም ብሎ ያስረዳል።

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

Insts የስራ ፍጠራ ቀላል ለማስተካከል ያደርጋል። ገፁ በተወሰነ አሰራር እየተዘጋጀ ይጀምራል፣ ወደ አጭር HTTP ጥያቄ ይንቀሳቀሳል፣ እና የተገደበ የሰራተኛ እንቅስቃሴ እንዳለ በግልጽ ይገልጻል።

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

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

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

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

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

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

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

curl https://insts.io/v1/jobs/CONNECT_JOB \
  -H "X-API-Key: $INSTS_CONNECT_SECRET"

ለስራ ምርመራ፣ Insts ከተገደበ በኋላ አንደኛ ሰከንድ የመጀመሪያ ቆይታን ይፈትሻል። ይህ የምርመራ መስክ ጊዜያዊ የተፈረሰ እንዲደርስ እንዲገልጽ እንደሚያደርግ ነው።

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

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

የአሠራር ውል

Insts በእይታ ጊዜ የተመነ ደረጃ ገደቦችን በመስራት የምርመራ ስፍራን እና እያንዳንዱ አቅራቢ መንገድ ይጠብቃል።

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

የስኬማ መዳረሻ በ Insts ላይ ከመዳሰስ በፊት ከማነቃቃት ጋር ይጀምራል. ቀጣዩ እይታ የተመደበውን ማረጋገጫ ይሸፍናል. ገጹ የተመዘገቡ የጥያቄ ቅርጾችን ይታያል.

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

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

የስራ መስክ አጠቃቀም ጉዳይ፣ የተጠሪ ብዛት እና በምርመራ ላይ አገልግሎቶችን አጋር። Insts እንደ አንድ ጊዜ የተከራዩ ማረጋገጫ ከታይነት በፊት እና ወደ የተቀመጠ ሃሽ ሲቀንስ ያለውን ገደብ ይገምጻል።

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