Áú»¢¶Ä²©

19. API

§°§Ò§Ù§à§â

Áú»¢¶Ä²© API §á§à§Ù§Ó§à§Ý§ñ§Ö§ä §á§â§à§Ô§â§Ñ§Þ§Þ§ß§à §Ú§Ù§Ó§Ý§Ö§Ü§Ñ§ä§î §Ú §Ú§Ù§Þ§Ö§ß§ñ§ä§î §Ü§à§ß§æ§Ú§Ô§å§â§Ñ§è§Ú§ð Áú»¢¶Ä²©, §ä§Ñ§Ü§Ø§Ö §à§Ò§Ö§ã§á§Ö§é§Ú§Ó§Ñ§Ö§ä §Õ§à§ã§ä§å§á §Ü §Õ§Ñ§ß§ß§í§Þ §Ú§ã§ä§à§â§Ú§Ú. API §ê§Ú§â§à§Ü§à §Ú§ã§á§à§Ý§î§Ù§å§Ö§ä§ã§ñ §Õ§Ý§ñ:

• §³§à§Ù§Õ§Ñ§ß§Ú§ñ §ß§à§Ó§í§ç §á§â§Ú§Ý§à§Ø§Ö§ß§Ú§Û §Õ§Ý§ñ §â§Ñ§Ò§à§ä§í §ã Áú»¢¶Ä²©;
• §ª§ß§ä§Ö§Ô§â§Ñ§è§Ú§Ú Áú»¢¶Ä²© §ã§à §ã§ä§à§â§à§ß§ß§Ú§Þ §á§â§à§Ô§â§Ñ§Þ§Þ§ß§í§Þ §à§Ò§Ö§ã§á§Ö§é§Ö§ß§Ú§Ö§Þ;
• §¡§Ó§ä§à§Þ§Ñ§ä§Ú§Ù§Ñ§è§Ú§Ú §â§å§ä§Ú§ß§ß§í§ç §Ù§Ñ§Õ§Ñ§é.

Áú»¢¶Ä²© API §ñ§Ó§Ý§ñ§Ö§ä§ã§ñ API §ß§Ñ §à§ã§ß§à§Ó§Ö §Ó§Ö§Ò §Ú §á§à§ã§ä§Ñ§Ó§Ý§ñ§Ö§ä§ã§ñ §Ü§Ñ§Ü §é§Ñ§ã§ä§î §Ó§Ö§Ò-§Ú§ß§ä§Ö§â§æ§Ö§Û§ã§Ñ. §°§ß §Ú§ã§á§à§Ý§î§Ù§å§Ö§ä §á§â§à§ä§à§Ü§à§Ý JSON-RPC 2.0, §é§ä§à §Ú§Þ§Ö§Ö§ä §Õ§Ó§Ñ §Ù§ß§Ñ§é§Ö§ß§Ú§ñ:

• API §ã§à§ã§ä§à§Ú§ä §Ú§Ù §ß§Ñ§Ò§à§â§Ñ §à§ä§Õ§Ö§Ý§î§ß§í§ç §Þ§Ö§ä§à§Õ§à§Ó;
• §©§Ñ§á§â§à§ã§í §Ú §à§ä§Ó§Ö§ä§í §Þ§Ö§Ø§Õ§å §Ü§Ý§Ú§Ö§ß§ä§Ñ§Þ§Ú §Ú API §Ù§Ñ§Ü§à§Õ§Ú§â§à§Ó§Ñ§ß§í §ã §Ú§ã§á§à§Ý§î§Ù§à§Ó§Ñ§ß§Ú§Ö§Þ §æ§à§â§Þ§Ñ§ä§Ñ JSON.

§¢§à§Ý§Ö§Ö §á§à§Õ§â§à§Ò§ß§å§ð §Ú§ß§æ§à§â§Þ§Ñ§è§Ú§ð §à §á§â§à§ä§à§Ü§à§Ý§Ö §Ú JSON §Þ§à§Ø§ß§à §ß§Ñ§Û§ä§Ú §ß§Ñ §ã§ä§â§Ñ§ß§Ú§è§Ö §Ú .

§³§ä§â§å§Ü§ä§å§â§Ñ

API §ã§à§ã§ä§à§Ú§ä §Ú§Ù §â§ñ§Õ§Ñ §Þ§Ö§ä§à§Õ§à§Ó, §Ü§à§ä§à§â§í§Ö §å§ã§Ý§à§Ó§ß§à §ã§Ô§â§å§á§á§Ú§â§à§Ó§Ñ§ß§í §Ó §à§ä§Õ§Ö§Ý§î§ß§í§Ö API. §¬§Ñ§Ø§Õ§í§Û §Þ§Ö§ä§à§Õ §Ó§í§á§à§Ý§ß§ñ§Ö§ä §à§Õ§ß§å §à§ä§Õ§Ö§Ý§î§ß§å§ð §Ù§Ñ§Õ§Ñ§é§å. §¯§Ñ§á§â§Ú§Þ§Ö§â, §Þ§Ö§ä§à§Õ host.create §à§ä§ß§à§ã§Ú§ä§ã§ñ §Ü API §å§Ù§Ý§Ñ §ã§Ö§ä§Ú §Ú §Ú§ã§á§à§Ý§î§Ù§å§Ö§ä§ã§ñ §Õ§Ý§ñ §ã§à§Ù§Õ§Ñ§ß§Ú§ñ §ß§à§Ó§í§ç §å§Ù§Ý§à§Ó §ã§Ö§ä§Ú. §ª§ã§ä§à§â§Ú§é§Ö§ã§Ü§Ú §ã§Ý§à§Ø§Ú§Ý§à§ã§î §ä§Ñ§Ü, §é§ä§à API §Ú§ß§à§Ô§Õ§Ñ §ß§Ñ§Ù§í§Ó§Ñ§Ý§ã§ñ §Ü§Ñ§Ü "§Ü§Ý§Ñ§ã§ã§í".

§£§í§á§à§Ý§ß§Ö§ß§Ú§Ö §Ù§Ñ§á§â§à§ã§à§Ó

§¬§Ñ§Ü §ä§à§Ý§î§Ü§à §Ó§í §å§ã§ä§Ñ§ß§à§Ó§Ú§ä§Ö §Ó§Ö§Ò-§Ú§ß§ä§Ö§â§æ§Ö§Û§ã, §Ó§í §Þ§à§Ø§Ö§ä§Ö §Ú§ã§á§à§Ý§î§Ù§à§Ó§Ñ§ä§î §å§Õ§Ñ§Ý§Ö§ß§ß§í§Ö HTTP §Ù§Ñ§á§â§à§ã§í §Õ§Ý§ñ §Ó§í§Ù§à§Ó§Ñ API. §¹§ä§à§Ò§í §ï§ä§à §ã§Õ§Ö§Ý§Ñ§ä§î, §Ó§Ñ§Þ §ß§Ö§à§Ò§ç§à§Õ§Ú§Þ§à §à§ä§á§â§Ñ§Ó§Ý§ñ§ä§î HTTP POST §Ù§Ñ§á§â§à§ã§í §Ü §æ§Ñ§Û§Ý§å api_jsonrpc.php, §Ü§à§ä§à§â§í§Û §â§Ñ§ã§á§à§Ý§à§Ø§Ö§ß §Ó §á§Ñ§á§Ü§Ö §ã §Ó§Ö§Ò-§Ú§ß§ä§Ö§â§æ§Ö§Û§ã§à§Þ. §¯§Ñ§á§â§Ú§Þ§Ö§â, §Ö§ã§Ý§Ú §Ó§Ñ§ê Áú»¢¶Ä²© §Ó§Ö§Ò-§Ú§ß§ä§Ö§â§æ§Ö§Û§ã §å§ã§ä§Ñ§ß§à§Ó§Ý§Ö§ß §Ó http://company.com/zabbix, HTTP §Ù§Ñ§á§â§à§ã §Õ§Ý§ñ §Ó§í§Ù§à§Ó§Ñ §Þ§Ö§ä§à§Õ§Ñ apiinfo.version §Þ§à§Ø§Ö§ä §Ó§í§Ô§Ý§ñ§Õ§Ö§ä§î §á§â§Ú§Þ§Ö§â§ß§à §ä§Ñ§Ü:

POST http://company.com/zabbix/api_jsonrpc.php HTTP/1.1
       Content-Type: application/json-rpc

       {"jsonrpc":"2.0","method":"apiinfo.version","id":1,"auth":null,"params":{}}

§©§Ñ§á§â§à§ã §Õ§à§Ý§Ø§Ö§ß §Ú§Þ§Ö§ä§î §Ù§Ñ§Ô§à§Ý§à§Ó§à§Ü Content-Type, §Ü§à§ä§à§â§í§Û §Ù§Ñ§Õ§Ñ§ß §à§Õ§ß§Ú§Þ §Ú§Ù §ã§Ý§Ö§Õ§å§ð§ë§Ú§ç §Ù§ß§Ñ§é§Ö§ß§Ú§Û: application/json-rpc, application/json §Ú§Ý§Ú application/jsonrequest.

§±§â§Ú§Þ§Ö§â §â§Ñ§Ò§à§é§Ö§Ô§à §á§â§à§è§Ö§ã§ã§Ñ

§£ §ã§Ý§Ö§Õ§å§ð§ë§Ö§Þ §â§Ñ§Ù§Õ§Ö§Ý§Ö §Ó§í §á§â§à§Ô§å§Ý§ñ§Ö§ä§Ö§ã§î §á§à §ß§Ö§Ü§à§ä§à§â§í§Þ §á§â§Ú§Þ§Ö§â§Ñ§Þ §Ú§ã§á§à§Ý§î§Ù§à§Ó§Ñ§ß§Ú§ñ §Ò§à§Ý§Ö§Ö §Õ§Ö§ä§Ñ§Ý§î§ß§à.

§¡§å§ä§Ö§ß§ä§Ú§æ§Ú§Ü§Ñ§è§Ú§ñ

§±§â§Ö§Ø§Õ§Ö §é§Ö§Þ §Ó§í §ã§Þ§à§Ø§Ö§ä§Ö §Ù§Ñ§á§â§à§ã§Ú§ä§î §Ý§ð§Ò§í§Ö §Õ§Ñ§ß§ß§í§Ö §ã Áú»¢¶Ä²© §Ó§Ñ§Þ §ß§Ö§à§Ò§ç§à§Õ§Ú§Þ§à §Ó§í§á§à§Ý§ß§Ú§ä§î §Ó§ç§à§Õ §Ú §á§à§Ý§å§é§Ú§ä§î §Ü§Ý§ð§é §Ñ§å§ä§Ö§ß§ä§Ú§æ§Ú§Ü§Ñ§è§Ú§Ú. §¿§ä§à §Þ§à§Ø§ß§à §ã§Õ§Ö§Ý§Ñ§ä§î, §Ú§ã§á§à§Ý§î§Ù§å§ñ §Þ§Ö§ä§à§Õ user.login. §¥§Ñ§Ó§Ñ§Û§ä§Ö §á§â§Ö§Õ§á§à§Ý§à§Ø§Ú§Þ, §é§ä§à §Ó§í §ç§à§ä§Ú§ä§Ö §Ó§í§á§à§Ý§ß§Ú§ä§î §Ó§ç§à§Õ §ã §Ú§ã§á§à§Ý§î§Ù§à§Ó§Ñ§ß§Ú§Ö§Þ §ã§ä§Ñ§ß§Õ§Ñ§â§ä§ß§à§Ô§à §á§à§Ý§î§Ù§à§Ó§Ñ§ä§Ö§Ý§ñ Áú»¢¶Ä²© §¡§Õ§Þ§Ú§ß§Ú§ã§ä§â§Ñ§ä§à§â§Ñ. §´§à§Ô§Õ§Ñ §Ó§Ñ§ê JSON §Ù§Ñ§á§â§à§ã §Þ§à§Ø§Ö§ä §Ó§í§Ô§Ý§ñ§Õ§Ö§ä§î §ã§Ý§Ö§Õ§å§ð§ë§Ú§Þ §à§Ò§â§Ñ§Ù§à§Þ:

{
           "jsonrpc": "2.0",
           "method": "user.login",
           "params": {
               "user": "Admin",
               "password": "zabbix"
           },
           "id": 1,
           "auth": null
       }

§¥§Ñ§Ó§Ñ§Û§ä§Ö §á§à§Ù§ß§Ñ§Ü§à§Þ§Ú§Þ§ã§ñ §Ò§Ý§Ú§Ø§Ö §ã §Ù§Ñ§á§â§à§ã§à§Þ §à§Ò§ì§Ö§Ü§ä§Ñ. §°§ß §Ú§Þ§Ö§Ö§ä §ã§Ý§Ö§Õ§å§ð§ë§Ú§Ö §ã§Ó§à§Û§ã§ä§Ó§Ñ:

• jsonrpc - §Ó§Ö§â§ã§Ú§ñ §á§â§à§ä§à§Ü§à§Ý§Ñ JSON-RPC, §Ü§à§ä§à§â§Ñ§ñ §Ú§ã§á§à§Ý§î§Ù§å§Ö§ä§ã§ñ API; Áú»¢¶Ä²© API §â§Ö§Ñ§Ý§Ú§Ù§å§Ö§ä JSON-RPC §Ó§Ö§â§ã§Ú§Ú 2.0;
• method - §Þ§Ö§ä§à§Õ API, §Ü§à§ä§à§â§í§Û §Ó§í§Ù§í§Ó§Ñ§Ö§ä§ã§ñ;
• params - §á§Ñ§â§Ñ§Þ§Ö§ä§â§í, §Ü§à§ä§à§â§í§Ö §á§Ö§â§Ö§Õ§Ñ§ð§ä§ã§ñ API §Þ§Ö§ä§à§Õ§à§Þ;
• id - §á§â§à§Ú§Ù§Ó§à§Ý§î§ß§í§Û §Ú§Õ§Ö§ß§ä§Ú§æ§Ú§Ü§Ñ§ä§à§â §Ù§Ñ§á§â§à§ã§Ñ;
• auth - §Ü§Ý§ð§é §Ñ§å§ä§Ö§ß§ä§Ú§æ§Ú§Ü§Ñ§è§Ú§Ú §á§à§Ý§î§Ù§à§Ó§Ñ§ä§Ö§Ý§ñ; §ä§Ñ §Ü§Ñ§Ü §å §ß§Ñ§ã §Ö§Ô§à §Ö§ë§Ö §ß§Ö §Ú§Þ§Ö§Ö§ä§ã§ñ, §å§Ü§Ñ§Ø§Ö§Þ §Ö§Ô§à §â§Ñ§Ó§ß§í§Þ null.

§¦§ã§Ý§Ú §Ó§í §å§Ü§Ñ§Ù§Ñ§Ý§Ú §å§é§Ö§ä§ß§í§Ö §Õ§Ñ§ß§ß§í§Ö §á§â§Ñ§Ó§Ú§Ý§î§ß§à, §á§à§Ý§å§é§Ö§ß§ß§í§Û §à§ä API §à§ä§Ó§Ö§ä §Ò§å§Õ§Ö§ä §ã§à§Õ§Ö§â§Ø§Ñ§ä§î §Ü§Ý§ð§é §Ñ§å§ä§Ö§ß§ä§Ú§æ§Ú§Ü§Ñ§è§Ú§Ú §á§à§Ý§î§Ù§à§Ó§Ñ§ä§Ö§Ý§ñ:

{
           "jsonrpc": "2.0",
           "result": "0424bd59b807674191e7d77572075f33",
           "id": 1
       }

§£ §ã§Ó§à§ð §à§é§Ö§â§Ö§Õ§î, §à§Ò§ì§Ö§Ü§ä §à§ä§Ó§Ö§ä§Ñ §ã§à§Õ§Ö§â§Ø§Ú§ä §ã§Ý§Ö§Õ§å§ð§ë§Ú§Ö §ã§Ó§à§Û§ã§ä§Ó§Ñ:

• jsonrpc - §ã§ß§à§Ó§Ñ, §Ó§Ö§â§ã§Ú§ñ §á§â§à§ä§à§Ü§à§Ý§Ñ JSON-RPC;
• result - §Õ§Ñ§ß§ß§í§Ö §á§à§Ý§å§é§Ö§ß§ß§í§Ö §à§ä §Þ§Ö§ä§à§Õ§Ñ;
• id - §Ú§Õ§Ö§ß§ä§Ú§æ§Ú§Ü§Ñ§ä§à§â §ã§à§à§ä§Ó§Ö§ä§ã§ä§Ó§å§ð§ë§Ö§Ô§à §Ù§Ñ§á§â§à§ã§Ñ.

§±§à§Ý§å§é§Ö§ß§Ú§Ö §å§Ù§Ý§à§Ó §ã§Ö§ä§Ú

§´§Ö§á§Ö§â§î §å §ß§Ñ§ã §Ö§ã§ä§î §Ó§Ñ§Ý§Ú§Õ§ß§í§Û §Ü§Ý§ð§é §Ñ§å§ä§Ö§ß§ä§Ú§æ§Ú§Ü§Ñ§è§Ú§Ú §á§à§Ý§î§Ù§à§Ó§Ñ§ä§Ö§Ý§ñ, §Ü§à§ä§à§â§à§Û §Þ§à§Ø§ß§à §Ú§ã§á§à§Ý§î§Ù§à§Ó§Ñ§ä§î §Õ§Ý§ñ §Õ§à§ã§ä§å§á§Ñ §Ü §Õ§Ñ§ß§ß§í§Þ §Ó Áú»¢¶Ä²©. §¯§Ñ§á§â§Ú§Þ§Ö§â, §Õ§Ñ§Ó§Ñ§Û§ä§Ö §Ó§à§ã§á§à§Ý§î§Ù§å§Ö§Þ§ã§ñ §Þ§Ö§ä§à§Õ§à§Þ host.get, §é§ä§à§Ò§í §á§à§Ý§å§é§Ú§ä§î ID, §Ú§Þ§Ö§ß§Ñ §å§Ù§Ý§à§Ó §ã§Ö§ä§Ú §Ú §Ú§ß§ä§Ö§â§æ§Ö§Û§ã§í §Ó§ã§Ö§ç §ß§Ñ§ã§ä§â§à§Ö§ß§ß§í§ç §å§Ù§Ý§à§Ó §ã§Ö§ä§Ú:

{
           "jsonrpc": "2.0",
           "method": "host.get",
           "params": {
               "output": [
                   "hostid",
                   "host"
               ],
               "selectInterfaces": [
                   "interfaceid",
                   "ip"
               ]
           },
           "id": 2,
           "auth": "0424bd59b807674191e7d77572075f33"
       }

§°§Ò§ì§Ö§Ü§ä §à§ä§Ó§Ö§ä§Ñ §Ò§å§Õ§Ö§ä §ã§à§Õ§Ö§â§Ø§Ñ§ä§î §Ù§Ñ§ä§â§Ö§Ò§à§Ó§Ñ§ß§ß§í§Ö §Õ§Ñ§ß§ß§í§Ö §à §ï§ä§Ú§ç §å§Ù§Ý§Ñ§ç §ã§Ö§ä§Ú:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "hostid": "10084",
                   "host": "Áú»¢¶Ä²© server",
                   "interfaces": [
                       {
                           "interfaceid": "1",
                           "ip": "127.0.0.1"
                       }
                   ]
               }
           ],
           "id": 2
       }

§³§à§Ù§Õ§Ñ§ß§Ú§Ö §ß§à§Ó§à§Ô§à §ï§Ý§Ö§Þ§Ö§ß§ä§Ñ §Õ§Ñ§ß§ß§í§ç

§¥§Ñ§Ó§Ñ§Û§ä§Ö §ã§à§Ù§Õ§Ñ§Õ§Ú§Þ §ß§à§Ó§í§Û §ï§Ý§Ö§Þ§Ö§ß§ä §Õ§Ñ§ß§ß§í§ç §å "Áú»¢¶Ä²© server", §Ú§ã§á§à§Ý§î§Ù§å§ñ §Õ§Ñ§ß§ß§í§Ö, §Ü§à§ä§à§â§í§Ö §Þ§í §á§à§Ý§å§é§Ú§Ý§Ú §Ú§Ù §á§â§Ö§Õ§í§Õ§å§ë§Ö§Ô§à §Ù§Ñ§á§â§à§ã§Ñ host.get. §¿§ä§à §Þ§à§Ø§ß§à §ã§Õ§Ö§Ý§Ñ§ä§î §Ó§à§ã§á§à§Ý§î§Ù§à§Ó§Ñ§Ó§ê§Ú§ã§î §Þ§Ö§ä§à§Õ§à§Þ item.create:

{
           "jsonrpc": "2.0",
           "method": "item.create",
           "params": {
               "name": "Free disk space on $1",
               "key_": "vfs.fs.size[/home/joe/,free]",
               "hostid": "10084",
               "type": 0,
               "value_type": 3,
               "interfaceid": "1",
               "delay": 30
           },
           "auth": "0424bd59b807674191e7d77572075f33",
           "id": 3
       }

§µ§ã§á§Ö§ê§ß§í§Û §à§ä§Ó§Ö§ä §Ò§å§Õ§Ö§ä §ã§à§Õ§Ö§â§Ø§Ñ§ä§î ID §ä§à§Ý§î§Ü§à §é§ä§à §ã§à§Ù§Õ§Ñ§ß§ß§à§Ô§à §ï§Ý§Ö§Þ§Ö§ß§ä§Ñ §Õ§Ñ§ß§ß§í§ç, §Ü§à§ä§à§â§í§Û §Þ§à§Ø§Ö§ä §Ò§í§ä§î §ã§ã§í§Ý§Ü§à§Û §ß§Ñ §ï§ä§à§ä §ï§Ý§Ö§Þ§Ö§ß§ä §Õ§Ñ§ß§ß§í§ç §á§â§Ú §ã§Ý§Ö§Õ§å§ð§ë§Ú§ç §Ù§Ñ§á§â§à§ã§Ñ§ç:

{
           "jsonrpc": "2.0",
           "result": {
               "itemids": [
                   "24759"
               ]
           },
           "id": 3
       }

§³§à§Ù§Õ§Ñ§ß§Ú§Ö §ß§Ö§ã§Ü§à§Ý§î§Ü§Ú§ç §ä§â§Ú§Ô§Ô§Ö§â§à§Ó

§´§Ñ§Ü§Ú§Þ §à§Ò§â§Ñ§Ù§à§Þ §Ö§ã§Ý§Ú §Þ§Ö§ä§à§Õ§í §ã§à§Ù§Õ§Ñ§ß§Ú§ñ §á§â§Ú§ß§Ú§Þ§Ñ§ð§ä §Þ§Ñ§ã§ã§Ú§Ó§í, §Þ§í §Þ§à§Ø§Ö§ä §Õ§à§Ò§Ñ§Ó§Ú§ä§î §ß§Ö§ã§Ü§à§Ý§î§Ü§à §ä§â§Ú§Ô§Ô§Ö§â§à§Ó §Ó§à§ä §ä§Ñ§Ü:

{
           "jsonrpc": "2.0",
           "method": "trigger.create",
           "params": [
               {
                   "description": "Processor load is too high on {HOST.NAME}",
                   "expression": "{Linux server:system.cpu.load[percpu,avg1].last()}>5",
               },
               {
                   "description": "Too many processes on {HOST.NAME}",
                   "expression": "{Linux server:proc.num[].avg(5m)}>300",
               }
           ],
           "auth": "0424bd59b807674191e7d77572075f33",
           "id": 4
       }

§µ§ã§á§Ö§ê§ß§í§Û §à§ä§Ó§Ö§ä §Ò§å§Õ§Ö§ä §ã§à§Õ§Ö§â§Ø§Ñ§ä§î ID §ä§à§Ý§î§Ü§à §é§ä§à §ã§à§Ù§Õ§Ñ§ß§ß§í§ç §ä§â§Ú§Ô§Ô§Ö§â§à§Ó:

{
           "jsonrpc": "2.0",
           "result": {
               "triggerids": [
                   "17369",
                   "17370"
               ]
           },
           "id": 4
       }

§°§Ò§ß§à§Ó§Ý§Ö§ß§Ú§Ö §ï§Ý§Ö§Þ§Ö§ß§ä§Ñ §Õ§Ñ§ß§ß§í§ç

§¡§Ü§ä§Ú§Ó§Ú§â§å§Ö§Þ §ï§Ý§Ö§Þ§Ö§ß§ä §Õ§Ñ§ß§ß§í§ç, §ä§à §Ö§ã§ä§î, §å§Ü§Ñ§Ø§Ö§Þ §Ö§Þ§å §ã§à§ã§ä§à§ñ§ß§Ú§Ö "0":

{
           "jsonrpc": "2.0",
           "method": "item.update",
           "params": {
               "itemid": "10092",
               "status": 0
           },
           "auth": "0424bd59b807674191e7d77572075f33",
           "id": 5
       }

§µ§ã§á§Ö§ê§ß§í§Û §à§ä§Ó§Ö§ä §Ò§å§Õ§Ö§ä §ã§à§Õ§Ö§â§Ø§Ñ§ä§î ID §à§Ò§ß§à§Ó§Ý§Ö§ß§ß§à§Ô§à §ï§Ý§Ö§Þ§Ö§ß§ä§Ñ §Õ§Ñ§ß§ß§í§ç:

{
           "jsonrpc": "2.0",
           "result": {
               "itemids": [
                   "10092"
               ]
           },
           "id": 5
       }

§°§Ò§ß§à§Ó§Ý§Ö§ß§Ú§Ö §ß§Ö§ã§Ü§à§Ý§î§Ü§Ú§ç §ä§â§Ú§Ô§Ô§Ö§â§à§Ó

§¡§Ü§ä§Ú§Ó§Ú§â§å§Ö§Þ §ß§Ö§ã§Ü§à§Ý§î§Ü§à §ä§â§Ú§Ô§Ô§Ö§â§à§Ó, §ä§à §Ö§ã§ä§î, §å§Ü§Ñ§Ø§Ö§Þ §Ú§Þ §ã§à§ã§ä§à§ñ§ß§Ú§Ö 0:

{
           "jsonrpc": "2.0",
           "method": "trigger.update",
           "params": [
               {
                   "triggerid": "13938",
                   "status": 0
               },
               {
                   "triggerid": "13939",
                   "status": 0
               }
           ],
           "auth": "0424bd59b807674191e7d77572075f33",
           "id": 6
       }

§µ§ã§á§Ö§ê§ß§í§Û §à§ä§Ó§Ö§ä §Ò§å§Õ§Ö§ä §ã§à§Õ§Ö§â§Ø§Ñ§ä§î ID §à§Ò§ß§à§Ó§Ý§Ö§ß§ß§í§ç §ä§â§Ú§Ô§Ô§Ö§â§à§Ó:

{
           "jsonrpc": "2.0",
           "result": {
               "triggerids": [
                   "13938",
                   "13939"
               ]
           },
           "id": 6
       }

§°§Ò§â§Ñ§Ò§à§ä§Ü§Ñ §à§ê§Ú§Ò§à§Ü

§¥§à §ï§ä§à§Ô§à §Þ§à§Þ§Ö§ß§ä§Ñ §Ó§ã§× §é§ä§à §Þ§í §á§â§à§Ò§à§Ó§Ñ§Ý§Ú §â§Ñ§Ò§à§ä§Ñ§Ý§à §á§â§Ö§Ü§â§Ñ§ã§ß§à. §¯§à §é§ä§à §ã§Ý§å§é§Ú§ä§ã§ñ, §Ö§ã§Ý§Ú §Þ§í §á§à§á§â§à§Ò§å§Ö§Þ §Ó§í§á§à§Ý§ß§Ú§ä§î §ß§Ö§Ü§à§â§â§Ö§Ü§ä§ß§í§Û §Ù§Ñ§á§â§à§ã §Ü API? §¥§Ñ§Ó§Ñ§Û§ä§Ö §á§à§á§â§à§Ò§å§Ö§Þ §ã§à§Ù§Õ§Ñ§ä§î §Ö§ë§Ö §à§Õ§Ú§ß §å§Ù§Ö§Ý §ã§Ö§ä§Ú §á§â§Ú §á§à§Þ§à§ë§Ú §Ó§í§Ù§à§Ó§Ñ host.create, §ß§à §ß§Ö §ã§ä§Ñ§ß§Ö§Þ §å§Ü§Ñ§Ù§í§Ó§Ñ§ä§î §à§Ò§ñ§Ù§Ñ§ä§Ö§Ý§î§ß§í§Û §á§Ñ§â§Ñ§Þ§Ö§ä§â groups.

{
           "jsonrpc": "2.0",
           "method": "host.create",
           "params": {
               "host": "Linux server",
               "interfaces": [
                   {
                       "type": 1,
                       "main": 1,
                       "useip": 1,
                       "ip": "192.168.3.1",
                       "dns": "",
                       "port": "10050"
                   }
               ]
           },
           "id": 7,
           "auth": "0424bd59b807674191e7d77572075f33"
       }

§´§à§Ô§Õ§Ñ §à§ä§Ó§Ö§ä §Ò§å§Õ§Ö§ä §ã§à§Õ§Ö§â§Ø§Ñ§ä§î §ã§à§à§Ò§ë§Ö§ß§Ú§Ö §à§Ò §à§ê§Ú§Ò§Ü§Ö:

{
           "jsonrpc": "2.0",
           "error": {
               "code": -32602,
               "message": "Invalid params.",
               "data": "No groups for host \"Linux server\"."
           },
           "id": 7
       }

§¦§ã§Ý§Ú §á§â§à§Ú§Ù§à§ê§Ý§Ñ §à§ê§Ú§Ò§Ü§Ñ, §ä§à §Ó§Þ§Ö§ã§ä§à §ã§Ó§à§Û§ã§ä§Ó§Ñ result, §à§Ò§ì§Ö§Ü§ä §à§ä§Ó§Ö§ä§Ñ §Ò§å§Õ§Ö§ä §ã§à§Õ§Ö§â§Ø§Ñ§ä§î §ã§Ó§à§Û§ã§ä§Ó§à error §ã§à §ã§Ý§Ö§Õ§å§ð§ë§Ú§Þ§Ú §Õ§Ñ§ß§ß§í§Þ§Ú:

• code - §Ü§à§Õ §à§ê§Ú§Ò§Ü§Ú;
• message - §Ü§à§â§à§ä§Ü§à§Ö §à§á§Ú§ã§Ñ§ß§Ú§Ö §à§ê§Ú§Ò§Ü§Ú;
• data - §Ò§à§Ý§Ö§Ö §Õ§Ö§ä§Ñ§Ý§î§ß§à §ã§à§à§Ò§ë§Ö§ß§Ú§Ö §à§Ò §à§ê§Ú§Ò§Ü§Ö.

§°§ê§Ú§Ò§Ü§Ú §Þ§à§Ô§å§ä §Ó§à§Ù§ß§Ú§Ü§Ñ§ä§î §Ó §â§Ñ§Ù§ß§í§ç §ã§Ú§ä§å§Ñ§è§Ú§ñ§ç, §ä§Ñ§Ü§Ú§ç §Ü§Ñ§Ü, §ß§Ö§Ü§à§â§â§Ö§Ü§ä§ß§í§Ö §Ó§Ó§à§Õ§ß§í§Ö §Ù§ß§Ñ§é§Ö§ß§Ú§ñ, §á§â§Ö§Ó§í§ê§Ö§ß§Ú§Ö §Ó§â§Ö§Þ§Ö§ß§Ú §à§Ø§Ú§Õ§Ñ§ß§Ú§ñ §ã§Ö§ã§ã§Ú§Ú §Ú§Ý§Ú §á§à§á§í§ä§Ü§Ñ §Õ§à§ã§ä§å§á§Ñ §Ü §ß§Ö§ã§å§ë§Ö§ã§ä§Ó§å§ð§ë§Ú§Þ §à§Ò§ì§Ö§Ü§ä§Ñ§Þ. §£§Ñ§ê§Ö §á§â§Ú§Ý§à§Ø§Ö§ß§Ú§Ö §Õ§à§Ý§Ø§ß§à §Ú§Þ§Ö§ä§î §Ó§à§Ù§Þ§à§Ø§ß§à§ã§ä§î §Ü§à§â§â§Ö§Ü§ä§ß§à §à§Ò§â§Ñ§Ò§à§ä§Ñ§ä§î §ä§Ñ§Ü§Ú§Ö §Ó§Ú§Õ§í §à§ê§Ú§Ò§à§Ü.

§£§Ö§â§ã§Ú§Ú API

§¹§ä§à§Ò§í §å§á§â§à§ã§ä§Ú§ä§î §Ó§Ö§â§ã§Ú§à§ß§ß§à§ã§ä§î API, §ß§Ñ§é§Ú§ß§Ñ§ñ §ã Áú»¢¶Ä²© 2.0.4, §Ó§Ö§â§ã§Ú§ñ API §ã§à§Ó§á§Ñ§Õ§Ñ§Ö§ä §ã §Ó§Ö§â§ã§Ú§Ö§Û §ã§Ñ§Þ§Ú§Þ Áú»¢¶Ä²©. §£§í §Þ§à§Ø§Ö§ä§Ö §Ú§ã§á§à§Ý§î§Ù§à§Ó§Ñ§ä§î §Þ§Ö§ä§à§Õ apiinfo.version, §é§ä§à§Ò§í §å§Ù§ß§Ñ§ä§î §Ó§Ö§â§ã§Ú§ð API, §ã §Ü§à§ä§à§â§à§Û §Ó§í §â§Ñ§Ò§à§ä§Ñ§Ö§ä§Ö. §©§ß§Ñ§ß§Ú§Ö §Ó§Ö§â§ã§Ú§Ú §Þ§à§Ø§Ö§ä §á§â§Ú§Ô§à§Õ§Ú§ä§î§ã§ñ §Õ§Ý§ñ §Ü§à§â§â§Ö§Ü§ä§Ú§â§à§Ó§Ü§Ú §Ó§Ñ§ê§Ö§Ô§à §á§â§Ú§Ý§à§Ø§Ö§ß§Ú§ñ, §é§ä§à§Ò§í §Ú§ã§á§à§Ý§î§Ù§à§Ó§Ñ§ä§î §Ó§à§Ù§Þ§à§Ø§ß§à§ã§ä§Ú §Ü§à§ß§Ü§â§Ö§ä§ß§à§Û §Ó§Ö§â§ã§Ú§Ú API.

§®§í §Ô§Ñ§â§Ñ§ß§ä§Ú§â§å§Ö§Þ §à§Ò§â§Ñ§ä§ß§å§ð §ã§à§Ó§Þ§Ö§ã§ä§Ú§Þ§à§ã§ä§î §Ó §á§â§Ö§Õ§Ö§Ý§Ñ§ç §à§Õ§ß§à§Û §Þ§Ñ§Ø§à§â§ß§à§Û §Ó§Ö§â§ã§Ú§Ú. §±§â§Ú §Ó§í§á§à§Ý§ß§Ö§ß§Ú§Ú §ß§Ö§ã§à§Ó§Þ§Ö§ã§ä§Ú§Þ§í§ç §Ú§Ù§Þ§Ö§ß§Ö§ß§Ú§Û §Þ§Ö§Ø§Õ§å §Þ§Ñ§Ø§à§â§ß§í§Þ§Ú §Ó§í§á§å§ã§Ü§Ñ§Þ§Ú, §Þ§í §à§Ò§í§é§ß§à §à§ã§ä§Ñ§Ó§Ý§ñ§Ö§Þ §ã§ä§Ñ§â§í§Ö §æ§å§ß§Ü§è§Ú§Ú, §Ü§Ñ§Ü §å§ã§ä§Ñ§â§Ö§Ó§ê§Ú§Ö §Ó §ã§Ý§Ö§Õ§å§ð§ë§Ú§Þ §Ó§í§á§å§ã§Ü§Ö, §Ú §å§Õ§Ñ§Ý§ñ§Ö§Þ §Ú§ç §ä§à§Ý§î§Ü§à §Ó §Ó§í§á§å§ã§Ü§Ö, §ã§Ý§Ö§Õ§å§ð§ë§Ú§Þ §Ù§Ñ §ï§ä§Ú§Þ. §ª§ß§à§Ô§Õ§Ñ §Þ§í §Þ§à§Ø§Ö§Þ §å§Õ§Ñ§Ý§Ú§ä§î §æ§å§ß§Ü§è§Ú§Ú §Þ§Ö§Ø§Õ§å §Þ§Ñ§Ø§à§â§ß§í§Þ§Ú §Ó§í§á§å§ã§Ü§Ñ§Þ§Ú §Ò§Ö§Ù §á§â§Ö§Õ§à§ã§ä§Ñ§Ó§Ý§Ö§ß§Ú§ñ §Ü§Ñ§Ü§à§Û-§Ý§Ú§Ò§à §à§Ò§â§Ñ§ä§ß§à§Û §ã§à§Ó§Þ§Ö§ã§ä§Ú§Þ§à§ã§ä§Ú. §°§é§Ö§ß§î §Ó§Ñ§Ø§ß§à, §ß§Ú§Ü§à§Ô§Õ§Ñ §ß§Ö §á§à§Ý§Ñ§Ô§Ñ§ä§î§ã§ñ §ß§Ñ §Ü§Ñ§Ü§Ú§Ö-§Ý§Ú§Ò§à §å§ã§ä§Ñ§â§Ö§Ó§ê§Ú§Ö §æ§å§ß§Ü§è§Ú§Ú §Ú §Þ§Ú§Ô§â§Ú§â§à§Ó§Ñ§ä§î §ß§Ñ §ß§à§Ó§í§Ö §Ñ§Ý§î§ä§Ö§â§ß§Ñ§ä§Ú§Ó§í §Ü§Ñ§Ü §ä§à§Ý§î§Ü§à §Ò§å§Õ§Ö§ä §Ó§à§Ù§Þ§à§Ø§ß§à.

§¥§à§á§à§Ý§ß§Ú§ä§Ö§Ý§î§ß§Ñ§ñ §Ý§Ú§ä§Ö§â§Ñ§ä§å§â§Ñ

§´§Ö§á§Ö§â§î §Ó§í §Ù§ß§Ñ§Ö§ä§Ö §Õ§à§ã§ä§Ñ§ä§à§é§ß§à §Õ§Ý§ñ §ß§Ñ§é§Ñ§Ý§Ñ §â§Ñ§Ò§à§ä§í §ã Áú»¢¶Ä²© API, §ß§à §ß§Ö §à§ã§ä§Ñ§ß§Ñ§Ó§Ý§Ú§Ó§Ñ§Û§ä§Ö§ã§î §ß§Ñ §Õ§Ñ§ß§ß§à§Þ §ï§ä§Ñ§á§Ö. §¥§Ý§ñ §Õ§Ñ§Ý§î§ß§Ö§Û§ê§Ö§Ô§à §é§ä§Ö§ß§Ú§ñ §Þ§í §á§â§Ö§Õ§Ý§Ñ§Ô§Ñ§Ö§Þ §Ó§Ñ§Þ §Ó§Ù§Ô§Ý§ñ§ß§å§ä§î §ß§Ñ §ã§á§Ú§ã§à§Ü §Õ§à§ã§ä§å§á§ß§í§ç API.