Zabbix API允许以编程方式检索和修改Zabbix的配置,并提供对历史数据的访问。
广泛用于:创建新的应用程序以使用Zabbix;将Zabbix与第三方软件集成;自动执行常规任务。Zabbix API是基于Web的API,作为Web前端的一部分提供。它使用JSON-RPC 2.0协议,这意味着该API包含一组独立的方法;客户端和API之间的请求和响应使用JSON格式进行编码。
Zabbix API结构:由许多名义上分组的独立API方法组成。每个方法执行一个特定任务。
例如,方法 host.create 隶属于 host 这个API分组 ,用于创建新主机。
大多数API至少包含四种方法: get, create, update 和 delete ,
分别是检索,创建,更新和删除数据,但是某些API提供一套完全不同的一组方法。Zabbix API允许用户使用JSON RPC协议来创建、更新和获取Zabbix对象(如主机、监控项、
图表等)信息或者执行任何其他的自定义的任务。
######1.身份验证######
请求的 Content-Type 头部必须设置为以下值之一: application/json-rpc, application/json 或 application/jsonrequest。
[root@server1 ~]# vim zabbix-api curl -XPOST -H 'Content-Type: application/json-rpc' -d ' { "jsonrpc": "2.0", "method": "user.login", "params": { "user": "Admin", "password": "zabbix" }, "id": 1, "auth": null }' http://172.25.1.1/zabbix/api_jsonrpc.php
请求对象具有以下属性:
jsonrpc - API使用的JSON-RPC协议的版本; Zabbix API实现的JSON-RPC版本是2.0;
method - 被调用的API方法名;
params - 将被传递给API方法的参数;