ALGO RESTful API

የምርት መረጃ፡ RESTful API መመሪያ

Algo RESTful ኤፒአይ ተጠቃሚዎች በአልጎ IP Endpoints ላይ በኤችቲቲፒ/ኤችቲቲፒኤስ ጥያቄዎች አማካይነት በኔትወርካቸው ላይ እንዲደርሱ፣ እንዲቆጣጠሩ እና እርምጃዎች እንዲወስዱ ያስችላቸዋል። ይህ ሰነድ ከአልጎ መሳሪያዎች ጋር ለመገናኘት የሚያገለግሉ አንድ ወጥ እና አስቀድሞ የተገለጹ አገር አልባ የክዋኔዎች ስብስብ ያቀርባል። ኤፒአይ HTTP/HTTPS GET፣POST እና PUT ጥያቄዎችን ከJSON ክፍያ ጋር ይደግፋል።

ማረጋገጫ

በአልጎ RESTful API ሶስት አይነት ማረጋገጫዎች አሉ፡

• መደበኛ ማረጋገጫ (በነባሪነት የነቃ)
• መሰረታዊ ማረጋገጫ (አማራጭ)
• ምንም የማረጋገጫ ዘዴ የለም (አይመከርም፤ ለሙከራ ዓላማዎች ብቻ)

የምርት አጠቃቀም መመሪያዎች፡ RESTful API

ቅድመ-ሁኔታዎች

RESTful API ን ከማንቃትዎ በፊት አስቀድሞ የተዋቀሩ የNTP አገልጋዮችን ለመድረስ መሣሪያው የበይነመረብ ግንኙነት እንዳለው ያረጋግጡ። ምንም የበይነመረብ ግንኙነት ከሌለ፣ የአካባቢ NTP አገልጋይ ያዋቅሩ እና የአይፒ አድራሻውን ያስገቡ።

RESTful API በማንቃት ላይ

1. ወደ መሳሪያው ይግቡ web በይነገጽ እና ወደ የላቀ ቅንጅቶች አስተዳዳሪ ትር ይሂዱ።
2. ወደ ኤፒአይ ድጋፍ ክፍል ወደታች ይሸብልሉ እና RESTful API ን አንቃ።
3. የተፈለገውን የይለፍ ቃል ያዘጋጁ (ነባሪ የይለፍ ቃል፡ algo)። መደበኛ ማረጋገጫ በነባሪ የነቃ መሆኑን ልብ ይበሉ።

መሰረታዊ ማረጋገጫን ማንቃት (አማራጭ)

1. በውስጡ web በይነገጽ, ወደ የስርዓት ጥገና ትር ይሂዱ እና አወቃቀሩን ያውርዱ file.
2. ውቅሩን ይክፈቱ file ከማንኛውም የጽሑፍ አርታኢ ጋር እና የሚከተለውን መስመር ያክሉ፡ api.auth.basic = 1
3. የተሻሻለውን ውቅር ያስቀምጡ እና ይስቀሉ። file የመልሶ ማግኛ ውቅረትን በመጠቀም ወደ መሳሪያው ይመለሱ File በስርዓት ጥገና ትር ውስጥ ባህሪ.

ምንም የማረጋገጫ ዘዴን ማንቃት (አማራጭ)

የማረጋገጫ ዘዴን ለማንቃት RESTful API Password መስኩን ባዶ ይተውት። ይህ ዘዴ አይመከርም እና ምንም አይነት ደህንነት ስለማይሰጥ ለሙከራ ዓላማዎች ብቻ ጥቅም ላይ መዋል አለበት.

ቀላል የመቆጣጠሪያ በይነገጽን ማንቃት (አማራጭ)

1. በላዩ ላይ web በይነገጽ, ወደ የስርዓት ጥገና ትር ይሂዱ እና አወቃቀሩን ያውርዱ file.
2. ውቅሩን ይክፈቱ file የጽሑፍ አርታዒን በመጠቀም እና ሁለት መስመሮችን ያክሉ. የፍላጎትዎን የይለፍ ቃል ይለውጡ።
3. አስተዳዳሪ.web.sci = 1
4. Sci.admin.pwd =
5. የተሻሻለውን ውቅር ያስቀምጡ እና ይስቀሉ። file የመልሶ ማግኛ ውቅረትን በመጠቀም ወደ መሳሪያው ይመለሱ File በስርዓት ጥገና ትር ውስጥ ባህሪ.

ማረጋገጫ ኤስample ኮድ

እባክህ ኢሜይል አድርግ support@algosolutions.com መደበኛ ወይም መሰረታዊ ማረጋገጫ ከፈለጉ sample ኮድ።
ለተጨማሪ ድጋፍ ይደውሉ 604-454-3792 ወይም ኢሜይል support@algosolutions.com

የመረጃ ማሳወቂያዎች

ማስታወሻ
ማስታወሻ ጠቃሚ ዝማኔዎችን፣ መረጃዎችን እና መከተል ያለባቸውን መመሪያዎች ያመለክታል

ማስተባበያ

በዚህ ሰነድ ውስጥ ያለው መረጃ በሁሉም መልኩ ትክክል ነው ተብሎ ይታመናል ነገር ግን በአልጎ ዋስትና አይሰጥም. መረጃው ያለማሳወቂያ ሊለወጥ የሚችል ነው እና በምንም መልኩ በአልጎ ወይም በማናቸውም አጋሮቹ ወይም አጋሮቹ ቃል መግባት የለበትም። አልጎ እና አጋሮቹ እና አጋሮቹ በዚህ ሰነድ ውስጥ ላሉት ስህተቶች ወይም ግድፈቶች ምንም ሀላፊነት አይወስዱም። እንደዚህ አይነት ለውጦችን ለማካተት የዚህ ሰነድ ክለሳዎች ወይም የእሱ አዲስ እትሞች ሊወጡ ይችላሉ። Algo በማንኛውም የዚህ ማኑዋል አጠቃቀም ወይም እንደዚህ ያሉ ምርቶች፣ ሶፍትዌሮች፣ ፈርምዌር እና/ወይም ሃርድዌር ለሚከሰቱ ጉዳቶች ወይም የይገባኛል ጥያቄዎች ምንም አይነት ሃላፊነት አይወስድም። ከአልጎ የጽሁፍ ፈቃድ ውጭ የዚህ ሰነድ ክፍል በማንኛውም መልኩ ሊባዛ ወይም ሊተላለፍ አይችልም።
በሰሜን አሜሪካ ውስጥ ለተጨማሪ መረጃ ወይም ቴክኒካል ድጋፍ እባክዎን የአልጎ ድጋፍ ቡድንን ያነጋግሩ፡-

አልጎ የቴክኒክ ድጋፍ
1-604-454-3792
support@algosolutions.com

©2022 Algo የ Algo Communication Products Ltd የተመዘገበ የንግድ ምልክት ነው።
መብቱ በህግ የተጠበቀ ነው. ሁሉም ሌሎች የንግድ ምልክቶች የየባለቤቶቻቸው ንብረት ናቸው። ሁሉም ዝርዝሮች ያለማሳወቂያ ሊለወጡ ይችላሉ.

 አጠቃላይ

መግቢያ

ይህ ሰነድ በኤችቲቲፒ/ኤችቲቲፒኤስ ጥያቄዎች አማካኝነት Algo RESTful API በአውታረ መረብዎ ላይ ባሉ Algo IP Endpoints ላይ ለመድረስ፣ ለማቀናበር እና እርምጃዎችን ለመቀስቀስ እንዴት ጥቅም ላይ እንደሚውል እና እንዲሁም የተለያዩ የደህንነት ደረጃዎች ያላቸው ሁለት የማረጋገጫ ዘዴዎችን ያብራራል። ስርዓቶች በዚህ ሰነድ ውስጥ በተገለጹት አንድ ወጥ እና አስቀድሞ በተገለጸ ሀገር አልባ የክዋኔዎች ስብስብ አማካኝነት ከአልጎ መሳሪያዎች ጋር መስተጋብር መፍጠር ይችላል። ከJSON ክፍያ ጭነት ጋር ለሀብት URI ጥያቄዎች ቀርበዋል እና የJSON ምላሽ ይሰጣሉ። ኤችቲቲፒ/ኤችቲቲፒኤስ GET፣ POST እና PUT ጥያቄዎች ዩአርአይን ከJSON ክፍያ ጭነት ጋር ግብዓት ለማድረግ ይቀርባሉ (ለክፍያ ዝርዝር የትዕዛዝ ክፍልን ይመልከቱ)።

 ማረጋገጫ

ሶስት አይነት ማረጋገጫዎች አሉ፡-

•  መደበኛ (የሚመከር)
•  መሰረታዊ
•  ምንም (አይመከርም)

መደበኛ ማረጋገጫው በሃሽ ላይ የተመሰረተ የመልእክት ማረጋገጫ ኮድ (HMAC) ከSHA-256 ኮድ የተቀመጠ ዳይስት ይጠቀማል። መሰረታዊ ማረጋገጫ Base64 ኢንኮዲንግ ይጠቀማል እና በ HTTPS ላይ ብቻ ጥቅም ላይ መዋል አለበት. ምንም ማረጋገጫ ምንም ማረጋገጫ ስለማይሰጥ በከፍተኛ ጥንቃቄ ብቻ መጠቀም የለበትም። ለተጨማሪ ዝርዝሮች የማረጋገጫ መስፈርቶች ክፍልን ይመልከቱ።

ማዋቀር እና ማዋቀር

ቅድመ-ሁኔታዎች

•  ይህ ሰነድ የAlgo endpoint firmware ስሪት 3.3 ወይም ከዚያ በላይ እያሄደ ነው ብሎ ያስባል።
•  መደበኛ ማረጋገጫን ለመጠቀም በጠያቂው እና በአልጎ መሳሪያዎች መካከል ያለው የጊዜ ልዩነት ከ30 ሰከንድ ያነሰ መሆን አለበት።
• NTP (የአውታረ መረብ ጊዜ ፕሮቶኮል) ስራ ላይ መሆኑን ያረጋግጡ። የብጁ NTP አገልጋዮች አድራሻዎች በላቁ ቅንብሮች → የጊዜ ትር ውስጥ ሊዋቀሩ ይችላሉ።

ማስታወሻ
ቀድሞ የተዋቀሩ የNTP አገልጋዮች በይፋ የተስተናገዱ ናቸው፣ ስለዚህ እሱን ለማግኘት የበይነመረብ ግንኙነት ያስፈልጋል። ምንም የበይነመረብ ግንኙነት ከሌለ፣ የአካባቢ NTP አገልጋይ ያዋቅሩ እና የአይፒ አድራሻውን ያስገቡ።

• የአልጎ መሣሪያ ስርዓት ጊዜ ከትክክለኛው የሰዓት ሰቅ ጋር መስተካከልን ያረጋግጡ። ይህ ወደ የላቀ ቅንጅቶች → የጊዜ ትር በማሰስ ሊከናወን ይችላል።

 RESTful API በማንቃት ላይ

1. ወደ ውስጥ ይግቡ web በይነገጽ እና ወደ የላቁ ቅንብሮች → አስተዳዳሪ ትር ይሂዱ።
2. ወደ ኤፒአይ ድጋፍ ክፍል ወደ ታች ይሸብልሉ፣ RESTful API ን ያንቁ እና የይለፍ ቃሉን እንደፈለጉ ያቀናብሩ (የተሳሳተ የይለፍ ቃል፡ algo)
   ማስታወሻ
   መደበኛ ማረጋገጫ በነባሪነት ነቅቷል።

መሰረታዊ ማረጋገጫን አንቃ (አማራጭ)

1. በውስጡ web በይነገጽ, ወደ ሲስተም → የጥገና ትር ይሂዱ እና አወቃቀሩን ያውርዱ file.
2. ውቅሩን ይክፈቱ file ከማንኛውም የጽሑፍ አርታኢ ጋር እና የሚከተለውን መስመር ያክሉ፡ api.auth.basic = 1
3.  የተሻሻለውን ውቅር ያስቀምጡ እና ይስቀሉ። file የመልሶ ማግኛ ውቅረትን በመጠቀም ወደ መሳሪያው ይመለሱ File ባህሪ በስርዓት → የጥገና ትር ውስጥ።

የማረጋገጫ ዘዴ የለም (አማራጭ)

የማረጋገጫ ዘዴን ለማንቃት RESTful API Password መስኩን ባዶ ይተውት። ይህ ዘዴ አይመከርም እና ምንም አይነት ደህንነት ስለማይሰጥ ለሙከራ ዓላማዎች ብቻ ጥቅም ላይ መዋል አለበት.

ቀላል የመቆጣጠሪያ በይነገጽን ማንቃት (አማራጭ)

1. በላዩ ላይ web በይነገጽ, ወደ ሲስተም → የጥገና ትር ይሂዱ እና አወቃቀሩን ያውርዱ file.
2.  ውቅሩን ይክፈቱ file የጽሑፍ አርታዒን በመጠቀም እና ሁለት መስመሮችን ያክሉ. ቀይር ወደ ፍላጎትዎ የይለፍ ቃል. አስተዳዳሪ.web.sci = 1
   Sci.admin.pwd =
3.  የተሻሻለውን ውቅር ያስቀምጡ እና ይስቀሉ። file የመልሶ ማግኛ ውቅረትን በመጠቀም ወደ መሳሪያው ይመለሱ File ባህሪ በስርዓት → የጥገና ትር ውስጥ።

የማረጋገጫ መስፈርቶች

እባክህ ኢሜይል አድርግ support@algosolutions.com መደበኛ ወይም መሰረታዊ ማረጋገጫ ከፈለጉ sample ኮድ።

ከJSON ክፍያ ጭነት ጋር መደበኛ የማረጋገጫ ጥያቄ

በ HTTP/HTTPS ጥያቄ ውስጥ የሚፈለጉ ራስጌዎች
> የይዘት ዓይነት፡ “መተግበሪያ/json”
> ይዘት-ኤምዲ5፡ [content_md5] ምሳሌample
Content-MD5: 74362cc86588b2b3c5a4491baf80375b

ፍቃድ፡ hmac አስተዳዳሪ፡[nonce]፡[hmac_output]
የፈቃድ ራስጌዎች የሚከተሉትን ያካትታሉ:

1. ሕብረቁምፊው 'hmac admin' በመቀጠል ኮሎን'፡'።
2. Nonce – የዘፈቀደ ወይም የማይደጋገም እሴት፣ ከዚያም ኮሎን ':' ይከተላል።
3. Hmac_output - በመሣሪያዎ ላይ በተዋቀረው RESTful ኤፒአይ ይለፍ ቃል (ሚስጥራዊ-ቁልፍ) እና በኤችኤምኤሲ ግቤት የመነጨ ከዚህ በታች እንደሚከተለው ነው፡-
   [የጥያቄ_ስልት]፡[ጥያቄ_uri]፡[content_md5]፡[የይዘት_አይነት]፡[ጊዜamp]:[አንድ ጊዜ]

የኤችኤምኤሲ ግቤት ምሳሌample: ('algo' እንደ ሚስጥራዊ ቁልፍ በመጠቀም)
POST:/api/controls/tone/star:6e43c05d82f71e77c586e29edb93b129:application/json:1601312252:49936 SHA-256ን በመጠቀም ኤችኤምኤሲን በይለፍ ቃል እና በHMAC ግቤት ሕብረቁምፊ ማፍለቅ።
HMAC ውፅዓት ለምሳሌample: 2e109d7aeed54a1cb04c6b72b1d854f442cf1ca15eb0af32f2512dd77ab6b330

ቀን፡ ቀን፣ የቀን ወር፣ አመት ሰዓት፡ደቂቃ፡ ሰከንድ ጂኤምቲ
Example
ቀን፡ ሐሙስ፣ ሴፕቴምበር 22፣ 2022 02፡33፡07 ጂኤምቲ
መደበኛ ማረጋገጫ ከክፍያ ጭነት exampላይ:

 መደበኛ የማረጋገጫ ጥያቄ ያለ JSON ክፍያ

ከ3.1 ጋር ተመሳሳይ የሆነ ከይዘት ጋር የተያያዙ ራስጌዎች/hmac ግብዓት ተጥሏል።
HMAC ግብዓት፡ [የጥያቄ_ዘዴ]፡[request_uri]፡[ጊዜamp]:[አንድ ጊዜ] የኤችኤምኤሲ ግብዓት example: ('algo' እንደ ሚስጥራዊ ቁልፍ በመጠቀም)
አግኝ፡/api/settings/audio.page.vol:1601312252:49936
SHA-256ን በመጠቀም HMACን በይለፍ ቃል እና በHMAC ግቤት ሕብረቁምፊ ይፍጠሩ፡
HMAC ውፅዓት ለምሳሌample: c5b349415bce0b9e1b8122829d32fbe0a078791b311c4cf40369c7ab4eb165a8
መደበኛ ማረጋገጫ ያለ ክፍያ ጭነት exampላይ:

 መሰረታዊ የማረጋገጫ ጥያቄ

ይህ የማረጋገጫ ዘዴ ከመደበኛው ዘዴ ያነሰ አስተማማኝ ስለሆነ በጥንቃቄ ጥቅም ላይ መዋል አለበት.

ፍቃድ፡ መሰረታዊ [base64]
Exampላይ:
ፍቃድ፡ መሰረታዊ YWRtaW46YWxnbwo=
መሰረታዊ ማረጋገጫ exampላይ:

ትእዛዝ

 RESTful API ትዕዛዞች

ከታች ያሉት ሁሉም የሚደገፉ የኤፒአይ ትዕዛዞች ዝርዝር ነው።

ማስታወሻ
የPUT ጥያቄ ከዳግም ማስነሳት የሚተርፍ ቋሚ ሃብትን ይለውጣል ወይም ይፈጥራል፣ የPOST ጥያቄ ግን መሳሪያውን ለአሁኑ ክፍለ ጊዜ ብቻ ነው የሚቆጣጠረው።

መግለጫ	ዘዴ	ዩአርአይ	ጭነት መለኪያዎች	ተመለስ Example	ምርት	FW
የአንድ የተወሰነ መለኪያ እሴት ሰርስሮ ማውጣት።	አግኝ	/api/settings/[ቁልፍ-ስም] Ex./api/settings/audio.page.vol	ኤን/ኤ	{"audio.page.vol"፡ "-18dB"}	ሁሉም	> 3.3
በዲሲቤል የሚለካውን የድባብ ጫጫታ ይመልሱ። ድባብ የድምፅ ማካካሻ በመሠረታዊ መቼቶች -> ባህሪያት ትር ውስጥ መንቃት አለበት።	አግኝ	/api/info/audio.noise.level	ኤን/ኤ	{"audio.noise.level"፡ 72}	ድምጽ ማጉያዎች ድምጽ ማጉያዎችን ያሳያሉ	> 3.3
የዝውውር ግቤት ተርሚናል ሁኔታን ያውጡ።	አግኝ	/api/info/input.relay.status	ኤን/ኤ	{“input.relay.status”፡ “ስራ ፈት”} ወይም {“input.relay.status”፡ “ገባሪ”}	ከ 8063 በስተቀር ሁሉም ምርቶች ከሪሌይ ግብዓት ጋር.	> 4.1
የግቤት 1 ወይም የግቤት 2 ተርሚናሎች ሁኔታን ያውጡ።	አግኝ	/api/info/input.relay1.status ወይም /api/info/input.relay2.status	ኤን/ኤ	{“input.relay1.status”፡ “ስራ ፈት”} ወይም {“input.relay1.status”፡ “ገባሪ”}	8063	> 4.1
የቃና ዝርዝሩን ሰርስረው ያውጡ fileበአሁኑ ጊዜ ተጭኗል።	አግኝ	/api/info/tonelist	ኤን/ኤ	{"ቶንሊስት"፡["ቤል-ና.ዋቭ"፣ ደወል uk.wav፣፣ buzzer.wav፣…]}	ሁሉም	> 5.0
በሁኔታ ገጹ ላይ የሚታየውን የመሳሪያውን መረጃ ሰርስረው ያውጡ።	አግኝ	/api/መረጃ/ሁኔታ	ኤን/ኤ	ከሁኔታ ትር ሙሉ የመረጃ ዝርዝር።	ሁሉም	> 5.4

ስለ ገጽ ላይ የሚታየውን የምርት መረጃ ሰርስሮ ውሰድ።	አግኝ	/api/መረጃ/ስለ	ኤን/ኤ	ስለ ስለ ትሩ ሁሉም መረጃ አለ።	ሁሉም	> 5.4
በሚፈለገው የቀለም እና የስርዓተ-ጥለት መመዘኛዎች ስትሮብን ያግብሩ።	POST	/api/controls/strobe/ጀምር	ስርዓተ ጥለት፡ {0 – 15} color1: {ሰማያዊ፣ቀይ፣አምበር፣አረንጓዴ} መያዣ፡ {እውነት፣ ሀሰት}	ኤን/ኤ	8128(ጂ2) 8138 8190S	> 3.3
ስትሮብ ያቁሙ።	POST	/api/controls/strobe/stop	ኤን/ኤ	ኤን/ኤ	8128(ጂ2) 8138 8190S	> 3.3
አንድ ቃና አንዴ ያጫውቱ ወይም ያዙሩት።	POST	/api/controls/tone/ጅምር	መንገድ፡ {tone} ማለትም chime.wav loop: {እውነት, ሐሰት} ወይም {0, 1} ለምሳሌ {"መንገድ":"chime.wav", "loop":true}	ኤን/ኤ	ድምጽ ማጉያዎች 8301 8373 8028(ጂ2) 8201 8039	> 3.3
ድምጹን አቁም.	POST	/api/controls/ቃና/ማቆም	ኤን/ኤ	ኤን/ኤ	ድምጽ ማጉያዎች 8301 8373 8028(ጂ2) 8201 8039	> 3.3
ቀድሞ የተቀዳ መልእክት ወዳለው የስልክ ቅጥያ ይደውሉ።	POST	/api/መቆጣጠሪያዎች/ጥሪ/ጀምር	{"ቅጥያ":"2099"፣ “ቃና”፡”gong.wav”፣ “interval”:”0”፣ “maxdur”:”10″}	ኤን/ኤ	ድምጽ ማጉያዎች 8301 8410 8420	> 3.3
ጥሪውን ጨርስ።	POST	/api/controls/ጥሪ/አቁም	ኤን/ኤ	ኤን/ኤ	ድምጽ ማጉያዎች 8301 8410 8420	> 3.3

የአንድ-መንገድ ገጽ ጥሪን ጀምር። መሳሪያው የኦዲዮ ዥረቱን ከታለመለት ቅጥያ ይቀበላል።	POST	/api/መቆጣጠሪያዎች/ጥሪ/ገጽ	{"ቅጥያ": ”}	ኤን/ኤ	ድምጽ ማጉያዎች 8410 8420	> 5.3.4
የዒላማውን የመጨረሻ ነጥብ ዳግም አስነሳ.	POST	/api/controls/እንደገና አስነሳ	ኤን/ኤ	ኤን/ኤ	ሁሉም	> 3.3
በሩን ክፈቱ. "አካባቢያዊ" የአካባቢውን ቅብብሎሽ "netdc1" ይቆጣጠራል የርቀት አውታረ መረብ በር መቆጣጠሪያ (8063)	POST	/api/controls/በር/ክፈት።	በርይድ፡ {አካባቢያዊ፣ netdc1} * አማራጭ	ኤን/ኤ	8039 8028(ጂ2) 8201 8063	> 3.3
በሩን ቆልፈው.	POST	/api/መቆጣጠሪያዎች/በር/መቆለፊያ	በርይድ፡ {አካባቢያዊ፣ netdc1} * አማራጭ	ኤን/ኤ	8039 8028(ጂ2) 8201 8063	> 3.3
የ24v aux out relayን አንቃ።	POST	api/controls/24v/ አንቃ	ኤን/ኤ	ኤን/ኤ	8063	> 5.0
የ24v aux out relayን አሰናክል።	POST	api/controls/24v/ አሰናክል	ኤን/ኤ	ኤን/ኤ	8063	> 5.0
የውጤት ማስተላለፊያውን አንቃ።	POST	/api/controls/relay/enable	ኤን/ኤ	ኤን/ኤ	8063	> 5.0
የውጤት ማስተላለፊያውን አሰናክል።	POST	/api/controls/relay/አሰናክል	ኤን/ኤ	ኤን/ኤ	8063	> 5.0
የቅርብ ጊዜውን የጽኑ ትዕዛዝ ስሪት ለማግኘት የ Algo's firmware አገልጋይን ያረጋግጡ።	POST	/api/መቆጣጠሪያዎች/ማሻሻል/ቼክ	ኤን/ኤ	{“ስሪት”፡ “ተዘምኗል”} ወይም {"ስሪት":" ”}	ሁሉም	> 4.1
የቅርብ ጊዜውን የጽኑ ትዕዛዝ ስሪት ለማግኘት የ Algo's firmware አገልጋይን ይፈትሹ እና ወደዚያ ስሪት ያሻሽሉ።	POST	/api/መቆጣጠሪያዎች/ማሻሻል/ጀምር	ኤን/ኤ	{"ሁኔታ"፡ "ተዘምኗል"} ወይም {"ሁኔታ"፡ "ማሻሻል ”፣ “url”፡ url>} ወይም {"ሁኔታ": " ”}	ሁሉም	> 4.1
በማያ ገጹ ላይ ምስል ወይም ስርዓተ-ጥለት ያሳዩ።	POST	/api/controls/screen/ጅምር	ተመልከት በታች	ኤን/ኤ	8410 8420	> 5.3.4
የማሳያውን ስርዓተ-ጥለት ያቁሙ እና ወደ ነባሪ ማያ ገጽ ይመለሱ።	POST	/api/controls/screen/ stop	ኤን/ኤ	ኤን/ኤ	8410 8420	> 5.3.4

ዋናውን መተግበሪያ እንደገና ያስጀምሩ.	POST	/api/controls/እንደገና መጫን	ኤን/ኤ	ኤን/ኤ	ሁሉም	> 5.3.4
የቀጥታ የድምጽ ዥረት ማዳመጥ ጀምር። ዥረቱ የሚላክበትን የወደብ ቁጥር ያዋቅሩ።	POST	/api/controls/rx/ጅምር	{"ወደብ": }	ኤን/ኤ	ሁሉም	> 5.3.4
የቀጥታ የድምጽ ዥረት ማዳመጥ አቁም	POST	/api/controls/rx/stop	ኤን/ኤ	ኤን/ኤ	ሁሉም	> 5.3.4
የመልቲካስት ሁነታን ያዘጋጁ።	PUT	/api/state/mcast/update/	{"ሞድ":"ላኪ", "አድራሻ": , "ወደብ": , "አይነት":"rtp"} ወይም {"mode":"ላኪ", "አድራሻ": , "ወደብ": , "አይነት":"ፖሊ", "ቡድን":1} **ማስታወሻ**፡ ከዚህ ትእዛዝ በፊት መቆጣጠሪያዎች/ቃና/ጅምር ጥቅም ላይ ከዋሉ፣ድምፁ የሚጫወተው በአሁን ጊዜ መቼቶች ላይ ነው። web UI.	ኤን/ኤ	8301	> 5.0
ከJSON ክፍያ ጭነት ዋጋን ወደ አንድ የተወሰነ ግቤት ያስገቡ።	PUT	/ ኤፒአይ / ቅንብሮች	መለኪያ፡ {value} ለምሳሌ {“audio.page.vol”፡ “-3dB”}	ኤን/ኤ	8180(ጂ2) 8186 8190 8190S 8301 8373	> 3.3

 ቀላል የቁጥጥር በይነገጽ (SCI) ትዕዛዞች

ሁሉም የ SCI ትዕዛዞች የGET ጥያቄዎች ናቸው እና ለማረጋገጫ የተለመዱ መለኪያዎች "usi" እና "አስተዳዳሪ" አሏቸው።
Exampላይ:
አግኝ http:// /sci/controls/door/unlock?usr=admin&pwd=algo&doorid=local

መግለጫ	ዩአርአይ	ተጨማሪ ጭነት መለኪያዎች	ምርቶች	FW
በሩን ክፈቱ. "አካባቢያዊ" የአካባቢውን ቅብብሎሽ "netdc1" ይቆጣጠራል የርቀት አውታረ መረብ በር መቆጣጠሪያ (8063)	/sci/መቆጣጠሪያዎች/አድርግ ወይም/ክፈት።	በርይድ፡ {አካባቢያዊ፣ netdc1} * አማራጭ	8039 8028(ጂ2) 8201 8063	> 3.3
በሩን ቆልፈው.	/sci/መቆጣጠሪያዎች/አድርግ ወይም/መቆለፊያ	በርይድ፡ {አካባቢያዊ፣ netdc1} * አማራጭ	8039 8028(ጂ2) 8201 8063	> 3.3
አንድ ቃና አንዴ ያጫውቱ ወይም ያዙሩት።	/sci/መቆጣጠሪያዎች/ለመጀመር/ለመጀመር	መንገድ፡ {tone} ማለትም chime.wav loop: {እውነት, ሐሰት} ወይም {0, 1}	ሁሉም	> 3.3
ድምጹን አቁም.	/sci/controls/ወደ ne/ማቆም	ኤን/ኤ	ሁሉም	> 3.3
በሚፈለገው የቀለም እና የስርዓተ-ጥለት መመዘኛዎች ስትሮብን ያግብሩ።	/sci/controls/strobe/ጀምር	ስርዓተ ጥለት፡ {0 – 15} ቀለም1፡ {ሰማያዊ፣ ቀይ፣ አምበር፣ አረንጓዴ} ቀለም 2: {ሰማያዊ ፣ ቀይ ፣ አምበር ፣ አረንጓዴ} ledlvl፡ {1 – 255} መያዣ፡ {እውነት፣ ሐሰት}	8128(ጂ2) 8138 8190S	> 3.3
ስትሮብ ያቁሙ።	/sci/መቆጣጠሪያዎች/ስትሮብ/ማቆም	ኤን/ኤ	8128(ጂ2) 8138 8190S	> 3.3

ሰነዶች / መርጃዎች

	ALGO RESTful API [pdf] የተጠቃሚ መመሪያ AL061-GU-GF000API-001-R0፣ AL061-GU-CP00TEAM-001-R0፣ RESTful API፣ RESTful፣ API
	ALGO RESTful API [pdf] የተጠቃሚ መመሪያ AL061-GU-CP000API-230717፣ RESTful API፣ RESTful፣ API

ዋቢዎች

• የተጠቃሚ መመሪያ