iBCS Restful API V4
URL គ្រប់គ្រង
V230918W

ជាងview

ផលិតផលគ្រួសារ iBoot-G2, iBoot-PoE និង iBoot-PDU ផ្តល់នូវ API Restful សាមញ្ញ (URL Control) ដែលអនុញ្ញាតឱ្យអ្នកប្រើប្រាស់គ្រប់គ្រងពួកវាបានយ៉ាងងាយស្រួលពីពួកគេផ្ទាល់ webគេហទំព័រ និងវិបផតថល។ ទោះយ៉ាងណាក៏ដោយ នេះទាមទារចំណេះដឹងអំពីអាសយដ្ឋាន IP របស់ iBoot ដែលចាំបាច់ត្រូវគ្រប់គ្រង។ នេះមិនតែងតែអនុវត្តជាក់ស្តែងទេ។
ការភ្ជាប់អ៊ីនធឺណិតមួយចំនួនមិនផ្តល់អាសយដ្ឋាន IP ឋិតិវន្ត ដែលធ្វើឱ្យវាមិនអាចប្រើ Restful API មូលដ្ឋានបានទេ។ iBoot Cloud Services (iBCS) គឺជាដំណោះស្រាយដ៏ល្អឥតខ្ចោះចំពោះបញ្ហានេះ។
iBoots បង្កើតការតភ្ជាប់ទៅ iBCS សម្រាប់ការត្រួតពិនិត្យ និងត្រួតពិនិត្យ។ ដោយសារ iBCS មានអាសយដ្ឋាន IP ឋិតិវន្ត ក៏ដូចជាឈ្មោះដែន នេះធ្វើឱ្យវាជាដំណោះស្រាយដ៏ល្អឥតខ្ចោះចំពោះបញ្ហាដែលបានរៀបរាប់ខាងលើ។ ឯកសារនេះផ្តល់នូវការបញ្ជាក់សម្រាប់ s ទីមួយtage នៃ iBCS Restful API ។

Restful API v4 ជាក់លាក់

ការបន្ថែមសមត្ថភាពក្នុងការកំណត់រចនាសម្ព័ន្ធឧបករណ៍ពីពពកគឺជាធាតុផែនទីបង្ហាញផ្លូវរបស់ iBCS ។ ដល់ទីបញ្ចប់នេះ Dataprobe បានចេញផ្សាយ iBoot-G2 Restful API v3.2 ជាចំណុចចាប់ផ្តើមសម្រាប់ការកំណត់រចនាសម្ព័ន្ធគ្រួសារ iBCS G2 ។
Restful API ដែលគេស្គាល់ថា Restful API v4 នឹងរួមបញ្ចូលមុខងារ v3.2 ទាំងអស់ ដូចដែលវាមានស្រាប់ និងបន្ថែមការគាំទ្រមួយចំនួនសម្រាប់ការកំណត់រចនាសម្ព័ន្ធសម្រាប់ស៊េរី iBoot-PDU ។ iBCS គាំទ្រ API Restful ដែលមានមូលដ្ឋានលើ Token សម្រាប់ការគ្រប់គ្រង ត្រួតពិនិត្យ និងកំណត់រចនាសម្ព័ន្ធឧបករណ៍គ្រួសារ iBoot-G2 ។ កំណែទី 4 នឹងអនុញ្ញាតឱ្យស៊េរី iBoot-PDU ត្រូវបានសរសេរកម្មវិធីដោយប្រើប្រាស់ API ដែលមានមូលដ្ឋានលើ Token ដែលមានស្រាប់ និងពាក្យបញ្ជា Line Interface (CLI) ដែលបានបង្កើតរួចហើយនៅក្នុងឧបករណ៍ iBoot-PDU ។
Restful API v4 នឹងរួមបញ្ចូលការណែនាំរបស់អតិថិជនដូចខាងក្រោម៖

• Restful API គួរតែផ្អែកលើ Token ។
• Restful API គួរតែអាចទទួលបានទិន្នន័យកំណត់រចនាសម្ព័ន្ធ។
• Restful API នឹងអនុញ្ញាតឱ្យប្រើពាក្យបញ្ជា CLI ដែលមានស្រាប់ដែលបានកំណត់នៅក្នុង PDU ។

៣.១. សញ្ញាសម្ងាត់
និមិត្តសញ្ញាដែលមានការអនុញ្ញាតគឺត្រូវបានទាមទារសម្រាប់ការទំនាក់ទំនង API Restful ទាំងអស់។ សញ្ញាសម្ងាត់មានសុពលភាពរហូតដល់ចំនួនអសកម្មនៃកម្មវិធីបានកន្លងផុតទៅ។ កម្មវិធីកំណត់ម៉ោងអសកម្មគឺអាចសរសេរកម្មវិធីបានពី 1 នាទីទៅ 12 ខែ។ វាអាចត្រូវបានកម្មវិធីពី Restful API ឬតាមរយៈ Web UI និមិត្តសញ្ញាទាំងអស់អាចត្រូវបានដកហូតនៅពេលណាក៏បានតាមរយៈ Restful API v4.

• ថូខឹនអនុញ្ញាតនឹងត្រូវបានទទួលពី៖ https://iboot.co/services/v4/auth
  សំណើការអនុញ្ញាតនឹងប្រើរចនាសម្ព័ន្ធ JSON ខាងក្រោម៖
• សំណើអនុញ្ញាតនឹងឆ្លើយតបជាមួយនឹងរចនាសម្ព័ន្ធ JSON ខាងក្រោម៖

៤.១. គ្រប់គ្រង
iBCS Control Restful API នឹងដំណើរការដូចគ្នានឹង Control Restful API បច្ចុប្បន្នដែរ។ ការផ្លាស់ប្តូរតែមួយគត់គឺត្រូវប្រើសញ្ញាអនុញ្ញាត។

• ការគ្រប់គ្រងនឹងត្រូវបានចូលប្រើនៅ៖ https://iboot.co/services/v4/control
• ការគ្រប់គ្រងនឹងប្រើរចនាសម្ព័ន្ធ JSON ខាងក្រោម៖
• ការគ្រប់គ្រងនឹងឆ្លើយតបជាមួយនឹងរចនាសម្ព័ន្ធ JSON ខាងក្រោម៖

៣.៣. ទៅយក
មុខងារ iBCS Retrieve Restful API នឹងអនុញ្ញាតឱ្យអ្នកប្រើប្រាស់ទាញយកព័ត៌មាននៅលើឧបករណ៍ច្រើនជាងមួយក្នុងពេលតែមួយ។ អ្នកប្រើប្រាស់អាចទាញយកស្ថានភាពឧបករណ៍ទាំងអស់នៅក្នុងគណនីរបស់ពួកគេ ឧបករណ៍ទាំងអស់នៅក្នុងទីតាំងជាក់លាក់ ឬស្ថានភាពគ្រាន់តែជាប្រភេទឧបករណ៍ជាក់លាក់មួយ។

• ការទាញយកនឹងត្រូវបានចូលប្រើនៅ៖ https://iboot.co/services/v4/retrieve
• Retrieve នឹងប្រើរចនាសម្ព័ន្ធ JSON ដូចខាងក្រោមមួយ៖

ទាញយកទាំងអស់។
កំណែនៃពាក្យបញ្ជាទាញយកមកវិញនេះនឹងទាញយកស្ថានភាពនៃឧបករណ៍ទាំងអស់នៅក្នុងគណនី។
អ្នកប្រើប្រាស់អាចជ្រើសរើសជាជម្រើសឧបករណ៍ទាំងអស់នៃប្រភេទជាក់លាក់មួយ។ទៅយកទីតាំង
កំណែនៃពាក្យបញ្ជាទាញយកមកវិញនេះនឹងទាញយកស្ថានភាពនៃឧបករណ៍ទាំងអស់នៅក្នុងទីតាំងដែលបានជ្រើសរើស។ អ្នកប្រើប្រាស់អាចជ្រើសរើសជាជម្រើសឧបករណ៍ទាំងអស់នៃប្រភេទជាក់លាក់មួយ។ទាញយកជាក់លាក់
កំណែ​នៃ​ពាក្យ​បញ្ជា​ទាញ​យក​នេះ​នឹង​ទៅ​យក​ស្ថានភាព​របស់​ឧបករណ៍​ដោយ​ប្រើ​អាសយដ្ឋាន MAC ដែល​បាន​ជ្រើស។

ទាញយកទម្រង់ឆ្លើយតប

• ការទាញយកនឹងឆ្លើយតបជាមួយនឹងរចនាសម្ព័ន្ធខាងក្រោមសម្រាប់ iBoot-G2/PoE៖
• ការទាញយកនឹងឆ្លើយតបជាមួយនឹងរចនាសម្ព័ន្ធខាងក្រោមសម្រាប់ iBoot-G2+/G2S៖
• ការទាញយកនឹងឆ្លើយតបជាមួយនឹងរចនាសម្ព័ន្ធ JSON ខាងក្រោមសម្រាប់ iBoot-PDU៖

៣.៤. ទាញយកតំណគ្រប់គ្រង PDU ដែលអាចចែករំលែកបាន។
មុខងារ iBCS Retrieve Manage Link នឹងអនុញ្ញាតឱ្យអ្នកប្រើប្រាស់ទាញយកតំណដែលអាចត្រូវបានចែករំលែកដើម្បីចូលដោយផ្ទាល់ទៅកាន់ឧបករណ៍ស៊េរី iBoot-PDU របស់ពួកគេ ដូចជាប្រសិនបើពួកគេបានចុចលើប៊ូតុងគ្រប់គ្រងដែលមាននៅក្នុង iBCS webទំព័រ។ តំណភ្ជាប់នឹងនៅតែមានសុពលភាពរយៈពេល 30 នាទី ហើយប្រសិនបើប្រើរយៈពេល 30 នាទីបន្ទាប់ពីអសកម្ម។

• ទាញយកតំណគ្រប់គ្រង PDU ដែលអាចចែករំលែកបាននឹងត្រូវបានចូលប្រើនៅ៖ https://iboot.co/services/v4/manage_link
• ទាញយកតំណគ្រប់គ្រង PDU ដែលអាចចែករំលែកបាននឹងប្រើរចនាសម្ព័ន្ធ JSON ខាងក្រោម៖
• ទាញយកតំណគ្រប់គ្រង PDU ដែលអាចចែករំលែកបាននឹងឆ្លើយតបជាមួយនឹងរចនាសម្ព័ន្ធ JSON ខាងក្រោម៖

៣.៥. ការកំណត់រចនាសម្ព័ន្ធ - ស៊េរី G3.5
Configuration Restful API v4 នឹងយកចំនួនអថេរនៃធាតុនៅក្នុងរចនាសម្ព័ន្ធ JSON ។ វានឹងអនុញ្ញាតឱ្យមានការផ្លាស់ប្តូរអថេរតែមួយ។ វាក៏នឹងអនុញ្ញាតឱ្យមានការផ្ញើអថេរពីទំព័រដំឡើងផ្សេងៗគ្នាក្នុងសំណើ API តែមួយ។ សូមមើលផ្នែកទី 4 និងទី 5 ខាងក្រោមសម្រាប់ព័ត៌មានលម្អិតទាក់ទងនឹងគ្រឿង iBoot ជាក់លាក់។

• ការកំណត់រចនាសម្ព័ន្ធទាំងអស់នឹងត្រូវធ្វើឡើងតាមរយៈ៖ https://iboot.co/services/v4/configuration/iBoot/set
• រចនាសម្ព័ន្ធ JSON នឹងតម្រូវឱ្យមានអថេរ iBoot យ៉ាងហោចណាស់ 1 ដើម្បីកំណត់រចនាសម្ព័ន្ធ។
• iBCS នឹងរក្សាទុកអថេរទាំងអស់នៅក្នុងមូលដ្ឋានទិន្នន័យ។
• iBCS នឹងដាក់ក្រុមអថេរដោយទំព័រកំណត់ផលិតផល។
• iBCS នឹងជំរុញអថេរទាំងអស់សម្រាប់ក្រុមដំឡើងដែលមានប្រសិទ្ធិភាពនីមួយៗ។
• iBCS នឹងរុញទិន្នន័យក្នុងទម្រង់ HTTP Post ។
• សំណើសំណុំកំណត់រចនាសម្ព័ន្ធនឹងប្រើរចនាសម្ព័ន្ធ JSON ខាងក្រោម៖
  វត្ថុ JSON៖
• ពាក្យបញ្ជា៖
• ការឆ្លើយតប៖

៣.៦. ការកំណត់រចនាសម្ព័ន្ធទទួលបាន - ស៊េរី G3.6
Configuration Restful API នឹងត្រូវបានប្រើដើម្បីទទួលបានការកំណត់រចនាសម្ព័ន្ធទាំងមូល ឬផ្នែកណាមួយនៃ iBoot ដែលបានជ្រើសរើស។ សូមមើលផ្នែកទី 6 និង 7 ខាងក្រោមសម្រាប់ព័ត៌មានលម្អិតទាក់ទងនឹងគ្រឿង iBoot ជាក់លាក់។

• ការ​កំណត់​រចនាសម្ព័ន្ធ​ទាំងអស់​នឹង​ត្រូវ​បាន​ធ្វើ​តាម​រយៈ៖ https://iboot.co/services/v4/configuration/iBoot/get
• ការកំណត់រចនាសម្ព័ន្ធទទួលបានសំណើនឹងប្រើរចនាសម្ព័ន្ធ JSON ខាងក្រោម៖
• ការកំណត់រចនាសម្ព័ន្ធទទួលបានសំណើនឹងឆ្លើយតបជាមួយនឹងរចនាសម្ព័ន្ធ JSON ខាងក្រោម៖

៣.៧. កំណត់រចនាសម្ព័ន្ធអនុវត្ត - ស៊េរី G3.7
ការកំណត់រចនាសម្ព័ន្ធ RestAPI នឹងប្រើវិធីនេះ (ចំណុចបញ្ចប់) ដើម្បីអនុវត្តការកំណត់រចនាសម្ព័ន្ធដែលបានជ្រើសរើសទៅក្នុងបញ្ជីឧបករណ៍ដែលបានជ្រើសរើស។

• ការ​កំណត់​រចនាសម្ព័ន្ធ​ទាំងអស់​នឹង​ត្រូវ​បាន​ធ្វើ​តាម​រយៈ៖ https://iboot.co/services/v4/configuration/iBoot/apply
• ពាក្យបញ្ជាអនុវត្តការកំណត់រចនាសម្ព័ន្ធនឹងប្រើរចនាសម្ព័ន្ធ JSON ខាងក្រោម៖
• ការឆ្លើយតប JSON

៣.៨. មូលដ្ឋានទិន្នន័យស្រមោល
វានឹងមិនមានប្រយោជន៍សម្រាប់ iBCS ដើម្បីដំណើរការសំណើសុំទទួលដោយការទាញយកការកំណត់រចនាសម្ព័ន្ធ iBoot ដោយផ្ទាល់ពី iBoot ។ ដើម្បីដោះស្រាយបញ្ហានេះ iBCS នឹងប្រើមូលដ្ឋានទិន្នន័យស្រមោល។

• មូលដ្ឋានទិន្នន័យស្រមោលនឹងមានអថេរ 1 សម្រាប់ទំព័ររៀបចំនីមួយៗនៃគ្រួសារ iBoot-G2 ។
• តារាងនីមួយៗនឹងមានអថេរសម្រាប់កំណែទាំងអស់នៃគ្រួសារ iBoot-G2 ។
• តារាងនីមួយៗនឹងចាប់ផ្តើមទទេរហូតដល់
  1. iBoot ផ្ញើការកំណត់របស់វាទៅពពកតាមរយៈ Commit Long Poll ។
  ▪ បន្ទាប់ពីការចាប់ផ្តើមឡើងវិញ ឬការផ្លាស់ប្តូរការកំណត់ដែលបានរក្សាទុកនៅលើ webទំព័រ
  2. Configuration Set Restful API ត្រូវបានប្រើ។
• Restful API Set នឹងអនុវត្តលំនាំដើមរបស់រោងចក្រចំពោះអថេរដែលមិនបានកំណត់ទាំងអស់។

ការកំណត់រចនាសម្ព័ន្ធ iBoot-G2

៤.១. ការកំណត់រចនាសម្ព័ន្ធឧបករណ៍
ខាងក្រោម​នេះ​ត្រូវ​បាន​ប្រើ​ដើម្បី​បង្ហោះ​រចនាសម្ព័ន្ធ JSON ដែល​នឹង​ធ្វើ​ការ​ផ្លាស់​ប្តូរ​ទៅ​លើ​ការ​កំណត់​ឧបករណ៍ iBoot-G2 ។ https://iboot.co/services/v4/configuration/iBoot/set
ចំណាំ៖ ប្រសិនបើទីតាំងត្រូវបានផ្លាស់ប្តូរ ការចាប់ផ្ដើមឡើងវិញគឺត្រូវបានទាមទារ។៤.២. ការកំណត់រចនាសម្ព័ន្ធបណ្តាញ ៤.៣. ការកំណត់រចនាសម្ព័ន្ធបណ្តាញកម្រិតខ្ពស់ ៤.៤. កំណត់ការកំណត់រចនាសម្ព័ន្ធស្វ័យប្រវត្តិ ៤.៥. ការកំណត់រចនាសម្ព័ន្ធកាលវិភាគ 4.6. ចាប់ផ្ដើមឡើងវិញ

ការកំណត់រចនាសម្ព័ន្ធ iBoot-G2+/S

ខាងក្រោមនេះត្រូវបានប្រើដើម្បីបង្ហោះរចនាសម្ព័ន្ធ JSON ដែលនឹងធ្វើការផ្លាស់ប្តូរទៅ iBoot-G2P ឬ iBoot-G2S
ការកំណត់ឧបករណ៍។ https://iboot.co/services/v4/configuration/iBoot/set
ចំណាំ៖ ប្រសិនបើទីតាំងត្រូវបានផ្លាស់ប្តូរ ការចាប់ផ្ដើមឡើងវិញគឺត្រូវបានទាមទារ។
៤.១. ការកំណត់រចនាសម្ព័ន្ធឧបករណ៍ ៥.២. កំណត់រចនាសម្ព័ន្ធពង្រីក៤.២. ការកំណត់រចនាសម្ព័ន្ធបណ្តាញ ៤.៣. ការកំណត់រចនាសម្ព័ន្ធបណ្តាញកម្រិតខ្ពស់ ៥.៥. ការកំណត់រចនាសម្ព័ន្ធបិទដោយប្រណិត ៤.៤. កំណត់ការកំណត់រចនាសម្ព័ន្ធស្វ័យប្រវត្តិ ៥.៧. ការកំណត់រចនាសម្ព័ន្ធចង្វាក់បេះដូង ៤.៥. ការកំណត់រចនាសម្ព័ន្ធកាលវិភាគ 5.9. ចាប់ផ្ដើមឡើងវិញ
រចនាសម្ព័ន្ធ JSON នេះត្រូវបានប្រើដើម្បីចាប់ផ្ដើម iBoot-G2 ឡើងវិញ។ វាមានឥទ្ធិពលដូចគ្នាក្នុងការចុចប៊ូតុងកំណត់ឡើងវិញនៅលើ iBoot-G2 ។

ការកំណត់រចនាសម្ព័ន្ធ iBoot-G2 ទទួលបាន

Restful API Configuration get គឺជាយន្តការមួយដែលអ្នកប្រើប្រាស់អាចស្នើសុំទិន្នន័យកំណត់រចនាសម្ព័ន្ធឧបករណ៍បច្ចុប្បន្នពី iBCS។
ខាងក្រោមនេះត្រូវបានប្រើដើម្បីបង្ហោះរចនាសម្ព័ន្ធ JSON ដែលនឹងទាញយកការកំណត់បច្ចុប្បន្ននៃការកំណត់ឧបករណ៍ iBoot-G2 ពី iBCS ។ https://iboot.co/services/v4/configuration/iBoot/get នៅពេលបង្ហោះរចនាសម្ព័ន្ធ JSON ខាងលើទៅ iBCS នោះ iBCS នឹងត្រឡប់ការកំណត់បច្ចុប្បន្នសម្រាប់បញ្ជីតារាងដែលបានបញ្ជាក់។ ការឆ្លើយតបទៅនឹងការកំណត់រចនាសម្ព័ន្ធ Restful API ទទួលបាននឹងមានដូចខាងក្រោម៖ [sampទិន្នន័យបានបង្ហាញ] ៦.១. ការកំណត់រចនាសម្ព័ន្ធឧបករណ៍ទទួលបាន ៦.២. ការកំណត់រចនាសម្ព័ន្ធបណ្តាញ ទទួលបាន ៦.៣. ការកំណត់រចនាសម្ព័ន្ធបណ្តាញកម្រិតខ្ពស់ ទទួលបាន ៦.៤. ការកំណត់រចនាសម្ព័ន្ធស្វ័យប្រវត្តិ ទទួលបាន ៦.៥. ការកំណត់រចនាសម្ព័ន្ធកាលវិភាគ ទទួលបាន

ការកំណត់រចនាសម្ព័ន្ធ iBoot-G2+/S ទទួលបាន

Restful API Configuration get គឺជាយន្តការមួយដែលអ្នកប្រើប្រាស់អាចស្នើសុំទិន្នន័យកំណត់រចនាសម្ព័ន្ធឧបករណ៍បច្ចុប្បន្នពី iBCS។
ខាងក្រោមនេះត្រូវបានប្រើដើម្បីបង្ហោះរចនាសម្ព័ន្ធ JSON ដែលនឹងទាញយកការកំណត់បច្ចុប្បន្ននៃការកំណត់ឧបករណ៍ iBoot-G2+ និង G2S ពី iBCS ។ https://iboot.co/services/v4/configuration/iBoot/get នៅពេលបង្ហោះរចនាសម្ព័ន្ធ JSON ខាងលើទៅ iBCS នោះ iBCS នឹងត្រឡប់ការកំណត់បច្ចុប្បន្នសម្រាប់បញ្ជីតារាងដែលបានបញ្ជាក់។ ការឆ្លើយតបទៅនឹងការកំណត់រចនាសម្ព័ន្ធ Restful API ទទួលបាននឹងមានដូចខាងក្រោម៖ [sampទិន្នន័យបានបង្ហាញ] ៦.១. ការកំណត់រចនាសម្ព័ន្ធឧបករណ៍ទទួលបាន ៧.២. ការកំណត់រចនាសម្ព័ន្ធពង្រីក ទទួលបាន ៦.២. ការកំណត់រចនាសម្ព័ន្ធបណ្តាញ ទទួលបាន ៦.៣. ការកំណត់រចនាសម្ព័ន្ធបណ្តាញកម្រិតខ្ពស់ ទទួលបាន ៧.៥. ការកំណត់រចនាសម្ព័ន្ធការបិទដោយប្រណិត ទទួលបាន ៦.៤. ការកំណត់រចនាសម្ព័ន្ធស្វ័យប្រវត្តិ ទទួលបាន ៧.៧. ការកំណត់រចនាសម្ព័ន្ធចង្វាក់បេះដូង ទទួលបាន ៦.៥. ការកំណត់រចនាសម្ព័ន្ធកាលវិភាគ ទទួលបាន

ការកំណត់រចនាសម្ព័ន្ធ iBoot-PDU

៤.១. ការកំណត់រចនាសម្ព័ន្ធឧបករណ៍
ខាងក្រោមនេះត្រូវបានប្រើដើម្បីបង្ហោះរចនាសម្ព័ន្ធ JSON ដែលនឹងផ្ញើពាក្យបញ្ជាកំណត់ iBoot-PDU CLI ទៅ iBootPDU ដើម្បីសរសេរកម្មវិធីការកំណត់នៅក្នុង iBoot-PDU ដែល CLI នឹង។
https://iboot.co/services/v4/configuration/pdu/set

• ពាក្យបញ្ជា៖
• ការឆ្លើយតប៖

ការកំណត់រចនាសម្ព័ន្ធឧបករណ៍ iBoot-PDU កំណត់រហ័ស ឧampលេ៖

៦.១. ការកំណត់រចនាសម្ព័ន្ធឧបករណ៍ទទួលបាន
ខាងក្រោមនេះត្រូវបានប្រើដើម្បី POST JSON រចនាសម្ព័ន្ធដែលនឹងផ្ញើ iBoot-PDU CLI ទទួលបានពាក្យបញ្ជាទៅ iBootPDU ដើម្បីទាញយកការកំណត់ពី iBoot-PDU ដែល CLI នឹង។
https://iboot.co/services/v4/configuration/pdu/get

• ពាក្យបញ្ជា៖
• ការឆ្លើយតប៖

ការកំណត់រចនាសម្ព័ន្ធឧបករណ៍ iBoot-PDU ទទួលបានរហ័ស ឧampលេ៖

Examples

ខាងក្រោមនេះគឺជាអតីតមួយចំនួនamples of iBoot-G2 family control, retrieve, configure get and configure set via Restful API v4.
៩.១. ទាញយក Token
ដើម្បីទាញយកសញ្ញាសម្ងាត់ដែលមានសុពលភាពពី iBCS តាមរយៈ API សម្រាប់ប្រើជាមួយពាក្យបញ្ជា API ជាបន្តបន្ទាប់ទាំងអស់។
ឈ្មោះអ្នកប្រើ និងពាក្យសម្ងាត់គឺសម្រាប់គណនី iBoot.co ។ សample នឹងទៅយកសញ្ញាសម្ងាត់ដែលមានសុពលភាពរយៈពេល 20 នាទីនៃភាពអសកម្មដោយប្រើឈ្មោះគណនី MyDemoUser និងពាក្យសម្ងាត់លេខសម្ងាត់ 123 ។ [ដូចផ្នែក ៣.១] គurl -d '{"ឈ្មោះអ្នកប្រើប្រាស់":"MyDemoUser","password":"Password123","អស់ពេល":{"interval":"20","scale":"minutes"}}' -X
ប្រកាស https://iboot.co/services/v4/auth
ពាក្យបញ្ជាខាងលើនឹងបង្ហាញរចនាសម្ព័ន្ធ JSON ដូចខាងក្រោម៖ {“success”:”true”,”token”:”e3ec-e4f6-910f-ac38″}
៩.២. iBoot-G9.2/PoE Control Example
ដើម្បីគ្រប់គ្រង iBoot-G2/PoE ទៅកាន់ Cycle តាមរយៈ RestFul API៖ [ដូចផ្នែក 3.2] curl -d '{“token”:”####-####-####-####”,”mac”:”00-0d-ad-01-02-03″,”ច្រកចេញ ”:”0″,”control”:”cycle”}' -X POST
https://iboot.co/services/v4/control
ពាក្យបញ្ជាខាងលើនឹងត្រឡប់រចនាសម្ព័ន្ធ JSON ដូចខាងក្រោម៖
{“success”:”true”,”message”:”បានផ្ញើ 'វដ្ត' ទៅហាង 00-0d-ad-01-02-03 (0)”}
៩.៣. iBoot ទាញយក Example
ដើម្បីសាកសួរស្ថានភាពឧបករណ៍ទាំងអស់នៅក្នុងគណនីតាមរយៈ RestFul API៖ [ដូចក្នុង Retrieve All section 3.3] curl -d '{"token":"####-####-###-####","all":[""]}' -X POST https://iboot.co/services/v4/retrieve
ពាក្យ​បញ្ជា​ខាង​លើ​នឹង​ត្រឡប់​រចនាសម្ព័ន្ធ JSON ដែល​ផ្អែក​លើ​ឯកតា​ទាំងអស់​ក្នុង​គណនី​ស្រដៀង​គ្នា​នឹង​ការ​ដូច​ខាង​ក្រោម៖
{“success”:”true”,”message”:null,”devices”:[{“mac”:”00-0d-ad-01-02-03″,”name”:”iBoot-G2-010203″, “online”:true,”location”:”on Desk”,”lastContact”:”2023-04-17 18:04:54″, “ip”:”192.168.1.205″,”status”:{“Main”:”ON”,”AP-1″:”Inactive”,”AP-2″:”Inactive”},”triggerInfo”:{“APT1″:”0”},
{“mac”:”00-0d-ad-0a-0b-0c”,”name”:”iBoot-G2-0a0b0c”,”online”:false,”location”:”at Home”,”lastContact”:”2023-01-12 10:02:32″, “ip”:”192.168.1.205″,”status”:{“Main”:”ON”,”AP-1″:”Inactive”,”AP-2″:”Inactive”}, “triggerInfo”:{“APT1″:”0”}}]}
៩.៤. iBoot-G9.4 ទាញយកជាក់លាក់ Example
ដើម្បីសាកសួរស្ថានភាព iBoot-G2/PoE តាមរយៈ RestFul API៖ [ដូចទៅនឹងការទាញយកផ្នែកជាក់លាក់ 3.3] curl -d '{"token":"####-####-####-####","mac":"00-0d-ad-01-02-03″}' - X ប្រកាស https://iboot.co/services/v4/retrieve
ពាក្យបញ្ជាខាងលើនឹងត្រឡប់រចនាសម្ព័ន្ធ JSON ដូចខាងក្រោម៖
{“success”:”true”,”message”:null,”devices”:[{“mac”:”00-0d-ad-01-02-03″,”name”:”iBoot-G2010203″,”online”:true,”location”:”on Desk”,”lastContact”:”2023-04-14 18:04:54″, “ip”:”192.168.1.254″,”status”:{“Main”:”ON”,”AP-1″:”Inactive”,”AP-2″:”Inactive”},”triggerInfo”:{“APT1″:”0”}}]}
៩.៥. iBoot-PDU ទាញយកតំណគ្រប់គ្រងដែលអាចចែករំលែកបាន។
ស៊េរី iBoot-PDU អនុញ្ញាតឱ្យប៊ូតុងគ្រប់គ្រងពីខាងក្នុងចំណុចប្រទាក់ iBCS ។ API នឹងអនុញ្ញាតឱ្យទាញយកតំណមុខងារដូចគ្នាបេះបិទ ដែលអាចចែករំលែកបាន។ តំណនឹងផុតកំណត់បន្ទាប់ពី 30 នាទី ប្រសិនបើមិនប្រើ ហើយនឹងផុតកំណត់បន្ទាប់ពី 30 នាទីនៃភាពអសកម្មប្រសិនបើវាត្រូវបានប្រើប្រាស់។ [ដូចផ្នែក 3.4] គurl -d '{"token":"####-####-####-####","mac":"a8-e7-7d-01-02-03″}' - X ប្រកាស https://iboot.co/services/v4/manage_link
ពាក្យបញ្ជាខាងលើនឹងត្រឡប់រចនាសម្ព័ន្ធ JSON ដូចខាងក្រោម៖
{"success":"true","message":"https://########.device.iboot.co"}
៩.៦. iBoot-G9.6 កំណត់រចនាសម្ព័ន្ធ Example
ដើម្បីកំណត់រចនាសម្ព័ន្ធការកំណត់ឧបករណ៍នៃ iBoot-G2: នេះ។ample ផ្ញើទៅ iBoot ជាក់លាក់ដោយអាសយដ្ឋាន mac របស់វា [ដូចផ្នែក 3.5] គurl -d “{“token”:”####-####-####-####”,”mac”:”00-0d-ad-01-02-03″,”device”:{“location”:”iBoot-G2-010203″, “cycleTime”:”10″,”disableOff”:”0″,”initialState”:”last”,”upgradeEnable”:”0″,”autoLogout”:”60″}}” -X POST
https://iboot.co/services/v4/configuration/iBoot/set
ពាក្យបញ្ជាខាងលើនឹងត្រឡប់រចនាសម្ព័ន្ធ JSON ដូចខាងក្រោម៖
{“success”:”true”,”message”:{“0″:”បានផ្ញើ 'location=iBoot-G2-010203&cycle=10&iMain=2&aLog=60' ទៅឧបករណ៍ Old-G2 name (00-0d-ad-01- ០២-០៣)”}}
៩.៧. iBoot-G9.7 កំណត់រចនាសម្ព័ន្ធ Get Example
ដើម្បីទាញយកការកំណត់រចនាសម្ព័ន្ធឧបករណ៍របស់ iBoot-G2 តាមរយៈ Restful API: This sample ស្នើសុំការកំណត់ឧបករណ៍ និងបណ្តាញនៃ iBoot-G2 ជាក់លាក់មួយ។ [ដូចក្នុងផ្នែក ៣.៦] គurl -d '{“token”:”####-####-####-####”,”mac”:”00-0d-ad-01-02-03″,”តារាង ”:[“ឧបករណ៍”,”បណ្តាញ”]}' –X POST
https://iboot.co/services/v4/configuration/iBoot/get
ពាក្យបញ្ជាខាងលើនឹងត្រឡប់រចនាសម្ព័ន្ធ JSON ដូចខាងក្រោម៖
{“success”:”true”,”device”:{“location”:”iBoot-G2010203″,”cycleTime”:10,”disableOff”:0,”initialState”:”last”,”upgradeEnable”:0,”autoLogout”:60},”network”:{“ipMode”:”static”,”ipAddress”:”192.168.1.254″,”subnetMask”:”255.255.255.0″,”gateway”:”192.168.1 .1″,”dns”:”192.168.1.1″}}
៩.៨. iBoot-G9.8+/S Control Example
ដើម្បីគ្រប់គ្រង iBoot-G2+/S ដើម្បីធ្វើវដ្តហាងទាំង 3 តាមរយៈ RestFul API: [ដូចផ្នែក 3.2] curl -d ‘{“token”:”####-####-####-####”,”mac”:”00-0d-ad-01-02-03″,”outlet”:[“0″,”1”,”2”],”control”:”cycle”}’ -X POST
https://iboot.co/services/v4/control
ពាក្យបញ្ជាខាងលើនឹងត្រឡប់រចនាសម្ព័ន្ធ JSON ដូចខាងក្រោម៖ {“success”:”true”,”message”:”បានផ្ញើ 'cycle' ទៅ 00-0d-ad-01-02-03 outlets (0, 1, 2)” }
៩.៩. iBoot-G9.9+/S ទាញយក Example
ដើម្បីសាកសួរស្ថានភាព iBoot-G2+ ឬ iBoot-G2S តាមរយៈ RestFul API៖ [ដូចទៅនឹងការទាញយកផ្នែកជាក់លាក់ 3.3] curl -d '{"token":"####-####-####-####","mac":"00-0d-ad-01-02-03″}' - X ប្រកាស https://iboot.co/services/v4/retrieve
ពាក្យបញ្ជាខាងលើនឹងត្រឡប់រចនាសម្ព័ន្ធ JSON ដូចខាងក្រោម៖
{“success”:”true”,”message”:null,”devices”:[{“mac”:”00-0d-ad-01-02-03″,”name”:”iBoot-G2S-010203″, “online”:true,”location”:”at Home”,”lastContact”:”2023-04-15 20:35:04″, “ip”:”192.168.1.208″,”status”:{“Main”:”ON”,”EXP-1″:”ON”,”EXP-2″:”ON”,”Main-2″:”ON”,”Input-1″:”Open”,”Input2″:”Open”,”Output-1″:”Closed”,”Output-2″:”Closed”,”AP-1A”:”Inactive”,”AP-1B”:”Inactive”,”AP-2″:”Inactive”,”AP3″:”Inactive”,”HB”:”Inactive”},”triggerInfo”:{“APT1″:”0″,”APT2″:”0″,”APT3″:”0″,”HBT1″:”0”}}]}
៩.១០. iBoot-G9.10+/S Configure Set Example
ដើម្បីកំណត់រចនាសម្ព័ន្ធការកំណត់កាលវិភាគនៃ iBoot-G2+ ឬ iBoot-G2S តាមរយៈ Restful API: Sample កំណត់ឯកតា iBoot-G2S ជាក់លាក់ ព្រឹត្តិការណ៍ទី 1 ជាថ្ងៃទី 4/24/2023 ដើម្បីបង្វិល Main នៅម៉ោង 10:05 ដោយធ្វើឡើងវិញប្រចាំថ្ងៃ។ [ដូចផ្នែក 5.8] គurl -d “{“token”:”####-####-####-####”,”mac”:”00-0d-ad-01-02-03″, “schedule”:{“date1″:”04/24/2023″,”time1″:”10:05″,”repeat1″:”1″,”repeatPeriod1″:”days”,”action1″:”cycle”,”outlet1″:” Main”,”enable1″:”1″}}” -X POST https://iboot.co/services/v4/configuration/iBoot/set
ពាក្យបញ្ជាខាងលើនឹងត្រឡប់រចនាសម្ព័ន្ធ JSON ដូចខាងក្រោម៖
ទោះបីជាកំណត់ព្រឹត្តិការណ៍តែ 1 ព្រឹត្តិការណ៍ទាំងអស់គឺជាផ្នែកមួយនៃការឆ្លើយតប។
{“success”:”true”,”message”:{“0″:”បានផ្ញើ
‘date1=04/24/2023&time1=10:05&rt1=1&rep1=0&act1=2&ctl1=0&run1=&date2=&date3=&date4=&date5=&date6=&date7=&date8=&time2=&time3=&time4=&time5=&time6=&time7=&time8=&rt2=0&rt3=0&rt4=0&rt5=0&rt6=0&rt7=0&rt8= 0&rep2=0&rep3=0&rep4=0&rep5=0&rep6=0&rep7=0&rep8=0&act2=0&act3=0&act4=0&act5=0&act6=0&act7=0&act8=0&run2=&run3=&run4=&run5=&run6=&run7=&run8=&date9=&dateA=&dateB=&dateC=&dateD=&dateE=&time9=&time A=&timeB=&timeC=&timeD=&timeE=&rt9=0&rtA=0&rtB=0&rtC=0&rtD=0&rtE=0&rep9=0&repA=0&repB=0&repC=0&repD=0&repE=0&act9=0&actA=0&actB=0&actC=0&actD=0&actE=0&run9=&runA=&runB=&runC=&runD=&runE=&ctl2=0&ctl 3=0&ctl4=0&ctl5=0&ctl6=0&ctl7=0&ctl8=0&ctl9=0&ctlA=0&ctlB=0&ctlC=0&ctlD=0&ctlE=0&clr2=Clear&clr3=Clear&clr4=C lear&clr5=Clear&clr6=Clear&clr7=Clear&clr8=Clear&clr9=Clear&clrA=Clear&clrB=Clear&clrC=Clear&clrD=Clear&clrE=Clear ‘ to device iBoot-G2S-010203 (00-0d-ad-01-02-03)”}}
៩.១១. iBoot-PDU Control Example
ដើម្បីគ្រប់គ្រងគ្រប់ច្រកចេញទាំងអស់នៃ iBoot-PDU តាមរយៈ RestFul API: [ដូចផ្នែក 3.2] curl -d ‘{“token”:”####-####-####-####”,”mac”:”a8-e7-7d-01-02-03″,”outlet”:[“0″,”1″,”2″,”3″,”4″,”5″,”6″,”7”], “control”:”cycle”}’ -X POST https://iboot.co/services/v4/control
ពាក្យបញ្ជាខាងលើនឹងត្រឡប់រចនាសម្ព័ន្ធ JSON ដូចខាងក្រោម៖
{“success”:”true”,”message”:”បានផ្ញើ 'វដ្ត' ទៅហាង a8-e7-7d-01-02-03 (0, 1, 2,3,4,5,6,7)”}
៩.១២. iBoot G9.12 series Reboot Example
ដើម្បីបង្ខំឱ្យដំណើរការ iBoot ឡើងវិញ (G2, PoE, G2S ឬ G2+) តាមរយៈ RestFul API: [ដូចផ្នែក 4.6 និង 5.9] curl -d '{“token”:”####-####-####-####”,”mac”:”00-0d-ad-01-02-03″,”ចាប់ផ្ដើមឡើងវិញ ”:”1″}' -X POST
https://iboot.co/services/v4/control
ពាក្យបញ្ជាខាងលើនឹងត្រឡប់រចនាសម្ព័ន្ធ JSON ដូចខាងក្រោម៖
{“success”:”true”,”message”:”បានផ្ញើ 'reboot=' ទៅ 00-0d-ad-01-02-03″}
៩.១៣. iBoot-PDU ទាញ​យក Example
ដើម្បីសាកសួរស្ថានភាព iBoot-PDU តាមរយៈ RestFul API៖ [ដូចក្នុង Retrieve Specific section 3.3] curl -d '{"token":"####-####-####-####","mac":"a8-e7-7d-01-02-03″}' - X ប្រកាស https://iboot.co/services/v4/retrieve
ពាក្យបញ្ជាខាងលើនឹងត្រឡប់រចនាសម្ព័ន្ធ JSON ដូចខាងក្រោម៖
{“success”:”true”,”message”:null,”devices”:[{“mac”:”a8-e7-7d-01-02-03″, “name”:”MainControlUnit”,”online”:true,”location”:”at Home”,”lastContact”:”2023-04-15 09:47:17″,”ip”:”0.0.0.0″,”status”:[{“Server”:”On”},{“Router”:”On”},{“Outlet-3″:”On”},{“Outlet-4″:”On”},{“Outlet5″:”On”},{“Outlet-6″:”On”},{“Outlet-7″:”Off”},{“Outlet-8″:”Off”}],”triggerInfo”:[]}]}
៩.១៤. សំណុំពាក្យបញ្ជា iBoot-PDU v9.14 Example
សample នឹងបន្ថែម និងកំណត់រចនាសម្ព័ន្ធលំដាប់មួយដែលមានឈ្មោះថា Wall to Schedule outlet 4 ដើម្បីបិទ រង់ចាំ 10 វិនាទី បន្ទាប់មកបើក outlet 4 ឡើងវិញ ហើយបន្ទាប់មកបង្កើតស្វ័យប្រវត្តិទៅ ping google.com រៀងរាល់ 30 វិនាទីជាមួយនឹងការបរាជ័យចំនួន 4 និងពេលវេលាចាប់ផ្តើមឡើងវិញ 60 វិនាទី។ ស្វ័យប្រវត្តិកម្មនឹងដំណើរការលំដាប់ Wall នៅពេលដែលវាបរាជ័យ។
សូមចំណាំថាពាក្យបញ្ជាចំនួន 25 គឺជាការធ្វើម្តងទៀតនូវអ្វីដែលវាត្រូវធ្វើដើម្បីរៀបចំកម្មវិធីលំដាប់ដូចគ្នា និងដំណើរការដោយស្វ័យប្រវត្តិដោយប្រើ CLI ប្រសិនបើភ្ជាប់ទៅចំណុចប្រទាក់ CLI របស់ឯកតា។
curl -d “{“token”:”####-####-####-####”,”mac”:”00-0d-ad-01-02-03″, “ពាក្យបញ្ជា ":[ "បន្ថែមលំដាប់ជញ្ជាំង","បន្ថែមលំដាប់សកម្មភាពជញ្ជាំង","បន្ថែមលំដាប់សកម្មភាពជញ្ជាំង","បន្ថែមលំដាប់សកម្មភាពជញ្ជាំង","កំណត់លំដាប់សកម្មភាពជញ្ជាំង 1 ប្រភេទច្រកចេញ","កំណត់លំដាប់សកម្មភាពជញ្ជាំង 1 ប៉ារ៉ាម៉ែត្រមូលដ្ឋានម៉ាស៊ីន", "កំណត់លំដាប់សកម្មភាពជញ្ជាំង 1 param1 2","កំណត់លំដាប់សកម្មភាពជញ្ជាំង 4 ប៉ារ៉ាម៉ែត្រ 1 បិទ", "កំណត់លំដាប់សកម្មភាពជញ្ជាំង 3 ប្រភេទពន្យាពេល", "កំណត់លំដាប់សកម្មភាពជញ្ជាំង 2 ប៉ារ៉ាម៉ែត្រ 2 1", "កំណត់លំដាប់សកម្មភាពជញ្ជាំង 10 ប្រភេទច្រកចេញ", "កំណត់លំដាប់សកម្មភាពជញ្ជាំង 3 param3 localhost","កំណត់លំដាប់សកម្មភាពជញ្ជាំង 1 param3 2","កំណត់លំដាប់សកម្មភាពជញ្ជាំង 4 param3 ON","កំណត់លំដាប់ជញ្ជាំងបានបើកពិត", "កំណត់លំដាប់គ្រប់គ្រងអ្នកប្រើប្រាស់ Wall yes","បន្ថែមការបំពេញដោយស្វ័យប្រវត្តិ Wall”,”កំណត់ការបិទជញ្ជាំងដោយស្វ័យប្រវត្តិ google.com”,”កំណត់ការបិទជញ្ជាំងដោយស្វ័យប្រវត្តិ 3″,”កំណត់ការរាប់ជញ្ជាំងដោយស្វ័យប្រវត្តិ 30″,”កំណត់ការបិទជញ្ជាំងដោយស្វ័យប្រវត្តិ 4″,”កំណត់ការបិទជញ្ជាំងដោយស្វ័យប្រវត្តិឡើងវិញ 2″,”កំណត់ការបិទជញ្ជាំងដោយស្វ័យប្រវត្តិ Wall”,”កំណត់ autoping Wall cleartriggersequence none”,”set autoping Wall enabled true”]}” -X POST https://iboot.co/services/v4/configuration/pdu/set
ពាក្យបញ្ជាខាងលើនឹងត្រឡប់រចនាសម្ព័ន្ធ JSON ដូចខាងក្រោម៖
{“success”:”true”,”message”:”add sequence Wall\n\nOk\nadd sequence Wall action\n\nOk\nadd sequence Wall action\n\nOk\nadd sequence Wall action\n\nOk\nកំណត់ លំដាប់សកម្មភាពជញ្ជាំង 1 ប្រភេទច្រកចេញ\n\nយល់ព្រម\nកំណត់លំដាប់សកម្មភាពជញ្ជាំង 1 param1 localhost\n\nយល់ព្រម\nកំណត់លំដាប់ សកម្មភាពជញ្ជាំង 1 param2 4\n\nយល់ព្រម\nកំណត់លំដាប់សកម្មភាពជញ្ជាំង 1 param3 បិទ\n\nយល់ព្រម\nកំណត់លំដាប់ជញ្ជាំង សកម្មភាព 2 ការពន្យាពេលប្រភេទ\n\nយល់ព្រម\nកំណត់លំដាប់ Wall action 2 param1 10\n\nOk\nset sequence Wall action 3 type outlet\n\nOk\nset sequence Wall action 3 param1 localhost\n\nOk\nset sequence Wall action 3 param2 4\n\nOk\nកំណត់លំដាប់ Wall action 3 param3 ON\n\nOk\nset sequence Wall បើក true\n\nOk\nកំណត់ user admin sequence Wall yes\n\nOk\nadd autoping Wall\n\nOk\nកំណត់ autoping អាសយដ្ឋានជញ្ជាំង google.com\n\nយល់ព្រម\nកំណត់ការបិទជញ្ជាំងដោយស្វ័យប្រវត្តិ 30\n\nOk\nកំណត់ការរាប់ជញ្ជាំងដោយស្វ័យប្រវត្តិ 4\n\nOk\nកំណត់ការអស់ពេលជញ្ជាំងដោយស្វ័យប្រវត្តិ 2\n\nOk\nកំណត់ស្វ័យប្រវត្តិកម្ម Wall restartdelay 60\n\nOk\ nset autoping Wall failtriggersequence Wall\n\nOk\nកំណត់ Autoping Wall cleartriggersequence none\n\nOk\nកំណត់ Autoping Wall បានបើក true\n\nOk"}

ជំនួយបច្ចេកទេស Dataprobe Inc
ផ្លូវពាណិជ្ជកម្ម 60E
Totowa New Jersey 07512
www.dataprobe.com/support
support@dataprobe.com
៨៦៦-៤៤៧-២១៩៤
៨៦៦-៤៤៧-២១៩៤
iBCS Restful API v4
V230918W

ឯកសារ/ធនធាន

dataprobe V230918W iBCS Restful API V4 URL គ្រប់គ្រង [pdf] ការណែនាំអ្នកប្រើប្រាស់ V230918W iBCS Restful API V4 URL ការគ្រប់គ្រង, V230918W, iBCS Restful API V4 URL គ្រប់គ្រង, Restful API V4 URL ការគ្រប់គ្រង, API V4 URL ការគ្រប់គ្រង, V4 URL ការត្រួតពិនិត្យ, URL គ្រប់គ្រង

ឯកសារយោង

• សៀវភៅណែនាំអ្នកប្រើប្រាស់