API接口

1. build
1. 内嵌web
- 2.1. dist.zip
- 2.2. build 内嵌资源 asset.go 文件
- 2.3. go-bindata 安装 (执行一次即可)
1. HTTP 接口
- 3.1. common
  - 3.1.1. userinfo
  - 3.1.2. iteminfo
- 3.2. login
- 3.3. logout
- 3.4. getitem
- 3.5. set_item 设置区域或者设备属性
- 3.6. SNMP 配置
  - 3.6.1. 获取配置文件
- 3.7. SNMP 批量配置
  - 3.7.1. 批量FTP升级
  - 3.7.2. 批量重启
  - 3.7.3. 批量恢复出厂设置
  - 3.7.4. 批量备份配置文件
  - 3.7.5. 批量配置
- 3.8. SNMP系统用户管理
  - 3.8.1. modify_password 修改自己的用户名和密码
  - 3.8.2. getusers -- for admin
  - 3.8.3. create_user -- for admin
  - 3.8.4. delete_user -- for admin
  - 3.8.5. modify_user -- for admin
- 3.9. 固件管理 -- for admin
  - 3.9.1. 固件查询
  - 3.9.2. 固件上传
- 3.10. FTP 固件升级
  - 3.10.1. ftp 升级
  - 3.10.2. ftp 升级状态查询
- 3.11. linux 命令
  - 3.11.1. 获取命令列接口
  - 3.11.2. 执行命令
- 3.12. SNMP Server 配置
  - 3.12.1. 获取配置
  - 3.12.2. 设置配置
- 3.13. 告警
  - 3.13.1. 获取告警
  - 3.13.2. 清除告警
- 3.14. 日志事件
  - 3.14.1. 日志查询接口
  - 3.14.2. 辅助查询转换接口
- 3.15. 系统自检
- 3.16. 图片上传接口

API接口

1. build

export GOPATH=`pwd`
cd src/snmp_server
make

./snmp_server -version

make debug or make release
- make debug == make
- make release 用于发布版本，会在git上打tag
version: 修改 src/snmp_server/VERSION 文件内容

2. 内嵌web

2.1. dist.zip

dist.zip 文件放到 src/snmp_server目录
unzip dist.zip 解压到 src/snmp_server目录，出现 src/snmp_server/dist 目录

2.2. build 内嵌资源 asset.go 文件

cd src/snmp_server 
go-bindata -o asset/asset.go -pkg=asset dist/...

2.3. go-bindata 安装 (执行一次即可)

export GOPATH=`pwd` #在snmp 目录设置
go get -u github.com/jteeuwen/go-bindata/...

安装完成后，把 pwd/bin 目录加入 PATH目录或者把 pwd/bin/go-bindata 文件�复制到 /usr/local/bin目录下面

3. HTTP 接口

3.1. common

3.1.1. userinfo

{
    "userid":int
    "usertype":int  -- 1 管理员， 2 普通用户
    "username": ""
    "password": ""  -- md5之后的值
    zoneinfo:
    {
        "zoneid": int   -- top(root) zone
        "zonename": ""  -- top(root) zone name
        "zonepath": ""  
        "imageurl": "" -- top(root) 的关联图片
    }
}

3.1.2. iteminfo

{
    
    "itemid":int
    "parent":int
    "itemname":""
    "itempath":""
    "itemtype":int 
    "status": int  -- for itemtype == 2
    "dev_type":"" -- 设备类型 for itemtype == 2
    "warnings":int -- for itemtype ==2 and status == 1
    "imageurl": "", -- for itemtype == 1, 关联的图片url
    "x": int,  -- x坐标,-1 表示没有设置坐标
    "y": int   -- y坐标,-1 表示没有设置坐标
            
}

3.2. login

POST
URL v1/login
Body

{
    "username":"",
    "password":md5("")
}

Response

{
    "result": 0         -- or other, 0 is ok
    "message": "OK"     -- or other error message
    "data":             -- if result == 0
    {
        "token":""      --登录成功后分配的token值，后续请求都需要
        "userinfo": userinfo
    }
}

Test

curl -X POST -H 'content-type: application/json' -d '{"username":"admin", "password":"123456"}' http://118.126.91.183:9192/v1/login

3.3. logout

POST
URL v1/logout
Body

{
    "token":""     -- login 返回的token
}

Response

{
    "result": 0         -- or other, 0 is ok
    "message": "OK"     -- or other error message
}

3.4. getitem

curl -X POST -H 'content-type: application/json' -d '{"token":"111-222-333-4444", "data":{"itemid":1, "itemtype":1}}' http://127.0.0.1:9192/v1/getitem

POST
URL v1/getitem
Body

{
    "token":""
    "data":
    {
        "itemid": int  -- zoneid or devid or userid
        "itemtype": int -- 1 zone, 2 dev , 3 user
    }
}

Response

{
    "result": 0         -- or other, 0 is ok, if ok has data
    "message": "OK"     -- or other error message
    "data":
    {
        "items":
        [
            iteminfo_1,
            iteminfo_2,
            ...
            iteminfo_i
        ]
    }
}

Test

curl -X POST -H 'content-type: application/json' -d '{"token":"111-222-333-4444", "data":{"itemid":1, "itemtype":1}}' http://118.126.91.183:9192/v1/getitem

3.5. set_item 设置区域或者设备属性

POST
URL : /v1/set_item
Body

{
	"token":"25dffd4f-0fe9-4cf8-af3c-4842e4716128",
	"data":
	{
		"itemid":2,
		"itemtype":1,  -- 1 for zone ， 2 for device
		"attrs":{
			"imageurl":"images/111.jpg", -- for  zone 
			"x":100,
			"y":200
		}
	}
}

attrs 目前只支持 imageurl,x,y 三个属性
x,y 必须同时包含
可以只包含 imageurl，或者只有 x和 y，也可以同时包含 imageurl,x,y
如果包含了服务器不识别的 attr，则被忽略
Response

{
    "result": 0         -- or other, 0 is ok, if ok has data
    "message": "OK"     -- or other error message
}

3.6. SNMP 配置

POST
URL v1/snmp
Body

{
    "token":""
    "data":
    {
        "snmp_type": ""  -- value is "get" or "set"
        "itemid":int     --  要操作的设备id 
        "index" : int    --- 一般填写0， 操作snmp table 填写索引值
        "oids":
        {
            一下成员，动态，根据具体页面设置即可, 对于get int填写0， string 填写 "" 
            "oid1": int or str
            "oid2" :int or str
            ....
            "oidi": int or str
        }
    }
}

Response

{
    "result": 0         -- or other, 0 is ok, if ok has data
    "message": "OK"     -- or other error message
    "data":             -- only for snmp_type is get 
    {
        "oids":
        {
            "oid1": int or str
            "oid2" :int or str
            ....
            "oidi": int or str
        }
    }
}

Test

curl -X POST -H 'content-type: application/json' -d '{"token":"111-222-333-4444", "data":{"snmp_type":"get", "itemid":4,"index":1,"oids":{"software_version":"","wan_link_status":0,"lan_link_status":0}}}' http://118.126.91.183:9192/v1/snmp

3.6.1. 获取配置文件

SNMP 配置更新之前，可以获取配置文件列表
POST
URL v1/get_config_file
Body

{
    "token":""
    "data":
    {
        "itemid": 5
    }
}

Response

{
    "result": 0         -- or other, 0 is ok, if ok has data
    "message": "OK"     -- or other error message
    "data":
    {
        "files":{
            file1,
            file2,
            ...,
            fileN
        }
    }
}

把获取到的files的任意一个文件名称放到 oids的字段 usl_ftp_restore_cfg_file_name 即可

3.7. SNMP 批量配置

说明，只能批量配置，归属自己的设备
POST
URL v1/snmp_batch
Body

{
    "token":""
    "data":
    {
        "dev_type": "" --要批量配置的设备类型
        "itempath": "" -- 指定 zone path �，在该path下面的所有指定设备会被批量处理
        "itemids": [id1,id2...], --优先，len(itemids) >0 忽略itempath
        "oids":
        {
            "oid1": int or str
            "oid2" :int or str
            ....
            "oidi": int or str
        }
    }
}

Response

{
    "result": 0         -- or other, 0 is ok, if ok has data
    "message": "OK"     -- or other error message
    "data":
    {
        "ok_items":   --所谓的成功是直snmp命令发送成功， 如果用于�固件 ftp升级，不代表固件ftp升级成功，只能说是把升级命令�发送到了设备
        [
            {
                "itemid":int,
                "itemname":""
            }
        ]
        "error_items":
        [
           {
               "itemid":int
               "itemname":""
               "error":""
           }
        ],

    }
}

3.7.1. 批量FTP升级

包含ftp升级相关参数

{
    "oids":
    {
        "usl_ftp_server_ip":"118.126.91.183",
        "usl_ftp_server_port":21,
        "usl_ftp_user_name":"uftp",
        "usl_ftp_user_passwd":"123456789",
        "usl_ftp_file_size":"380605",
        "usl_ftp_soft_file_name":"klph-40b19.tar"
    }
}

3.7.2. 批量重启

{
    "oids":
    {
        "usl_reboot_device":"reboot"
    }
}

3.7.3. 批量恢复出厂设置

{
    "oids":
    {
        "usl_set_default":"default"
    }
}

3.7.4. 批量备份配置文件

{
    "oids":
    {
        "usl_ftp_server_ip":"118.126.91.183",
        "usl_ftp_server_port":21,
        "usl_ftp_user_name":"uftp",
        "usl_ftp_user_passwd":"123456789",
        "usl_ftp_save_cfg_file_name":"default"
    }
}

usl_ftp_save_cfg_file_name 名称随意给即可，服务器会统一文件名称为设备的ntid_YYmmDD_HHMMSS.cfg

3.7.5. 批量配置

�以下列出的字段支持批量配置，可以出现在请求消息的oids参数中；

名称	jsonKey	默认值	说明
语言模式	k518_language_mode	缺省：0	//中文
http模式	k518_http_mode	缺省：0	//http模式
http端口	k518_http_port	缺省：80
telnet端口	k518_telnet_port	缺省：23
sip本地端口	k518_sip_local_port	缺省：5060
二次拨号模式	k518_dtmf_relay_mode	缺省：0	//2833模式
语音算法列表	k518_codec_type_list	缺省："3 1 0 4 2"
热线使能开关	k518_hotline_enable	缺省：0	//关闭
热线号码	k518_hotline_number	缺省："690"
热线账号	k518_hotline_account	缺省：0
麦克风音量	k518_microphone_volume	缺省：6
扬声器音量	k518_speaker_volume	缺省：4
挂机等待时间	k518_hookon_wait_time	缺省：10
铃声类型	k518_ring_style	缺省：0
振铃音量	k518_ring_volume	缺省：7
语言模式	k519_language_mode	缺省：0	//中文
http模式	k519_http_mode	缺省：0	//http模式
http端口	k519_http_port	缺省：80
telnet端口	k519_telnet_port	缺省：23
sip本地端口	k519_sip_local_port	缺省：5060
二次拨号模式	k519_dtmf_relay_mode	缺省：0	//2833模式
语音算法列表	k519_codec_type_list	缺省："3 1 0 4 2"
热线使能开关	k519_hotline_enable	缺省：0	//关闭
热线号码	k519_hotline_number	缺省："690"
热线账号	k519_hotline_account	缺省：0
视频模式	k519_video_mode	缺省：0	//720p
视频负载类型	k519_video_paytype	缺省：107
麦克风音量	k519_microphone_volume	缺省：6
扬声器音量	k519_speaker_volume	缺省：4
挂机等待时间	k519_hookon_wait_time	缺省：10
铃声类型	k519_ring_style	缺省：0
振铃音量	k519_ring_volume	缺省：7

3.8. SNMP系统用户管理

3.8.1. modify_password 修改自己的用户名和密码

POST
URL v1/modify_password
Body

{
    "token":""
    "data":
    {
        "userid": int -- user for modify
        "old_password":""  -- md5
        "new_password": "" -- md5
    }
}

Response

{
    "result": 0         -- or other, 0 is ok, if ok has data
    "message": "OK"     -- or other error message
}

3.8.2. getusers -- for admin

POST
URL v1/getusers
Body

{
    "token":""
    "data":
    {
        "zoneid": int 
    }
}

Response

{
    "result": 0         -- or other, 0 is ok, if ok has data
    "message": "OK"     -- or other error message
    "data":
    {
        "users":[
        userinfo_1,
        userinfo_2,
        ...
        userinfo_i
        ]
    }
}

3.8.3. create_user -- for admin

POST
URL v1/create_user
Body

{
    "token":"",
    "data":
    {
        "username":""
        "password": "" -- md5
        "usertype": int
        "zoneid":int -- parent zone id 
    }
}

Response

{
    "result": 0         -- or other, 0 is ok, if ok has data
    "message": "OK"     -- or other error message
}

3.8.4. delete_user -- for admin

POST
URL v1/delete_user
Body

{
    "token":"",
    "data":
    {
        "userid":int -- 要删除的用户id
    }
}

Response

{
    "result": 0         -- or other, 0 is ok, if ok has data
    "message": "OK"     -- or other error message
}

3.8.5. modify_user -- for admin

POST
URL v1/modify_user
Body

{
    "token":"",
    "data":
    {
        "userid": int  -- for modify user id 
        "usertype": int  --如果要修改用户类型，包含该字段
        "password": "" -- md5  如果要修改 密码，包含该字段
        "zoneid": int  -- 如果要修改管理的区域，包含该字段
    }
}

Response

{
    "result": 0         -- or other, 0 is ok, if ok has data
    "message": "OK"     -- or other error message
}

3.9. 固件管理 -- for admin

3.9.1. 固件查询

POST
URL v1/get_all_hardware
Body

{
    "token":""
    "data":{
        "dev_type":"KN518"| "KN519"
    }
}

Response

{
    "result": 0         -- or other, 0 is ok, if ok has data
    "message": "OK"     -- or other error message
    "data":
    {
        "files":
        [
            filename1,
            filename2,
            ....
            filenameN
        ]
    }
}

3.9.2. 固件上传

通过 From 表单上传

url : /v1/upload_hardware
dev_type == upgrade 时，为 snmp_server的升级。上传文件必须为tar文件。并且会被强制修改为 snmp.tar文件.

3.10. FTP 固件升级

3.10.1. ftp 升级

使用 �snmp set命令，参考 snmp接口；需要包含以下字段 usl_ftp_server_ip
usl_ftp_server_port
usl_ftp_user_name
usl_ftp_user_passwd
usl_ftp_file_size
usl_ftp_soft_file_name
URL v1/snmp

{
	"token":"111-222-333-4444",
	"data":
	{
		"snmp_type":"set",
		"itemid":5,
		"index":0,
		"oids":
		{
			"usl_ftp_server_ip":"118.126.91.183",
			"usl_ftp_server_port":21,
			"usl_ftp_user_name":"uftp",
			"usl_ftp_user_passwd":"123456789",
			"usl_ftp_file_size":"380605",
			"usl_ftp_soft_file_name":"klph-40b19.tar"
		}
	}
}

3.10.2. ftp 升级状态查询

POST
URL /v1/ftp_upgrade_status
Body

{
    "token":
    "data:"
    {
        itemid: int  -- 查询单个设备
        itempath: string --查询批量ftp升级
        dev_type: string --查询批量ftp升级
    }
}

Response

{
    "result": 0         -- or other, 0 is ok, if ok has data
    "message": "OK"     -- or other error message
    "data":
    {
       "upgrades": [ftp_upgrade_info...]
    }
}

ftp_upgrade_info

{
    itemid: int 
    itemname: string
    itempath: string
    dev_type: string
    result :
}

3.11. linux 命令

为了安全，只能�执行指定的系统命令。相关系统命令放在�与snmp_server 相同的目录 command.txt文件中。
command.txt 文件每行一个命令，每一行数据保护三个字段， index:name:command
index 必须唯一
name 为名称，用于web页面展示
command具体执行的内容，对web� 和用户透明。

3.11.1. 获取命令列接口

POST
URL : /v1/get_commands
Body

{
	"token":"8008fd2f-3ccd-4582-8756-ae3d13ea7f77"
}

Response

{
    "data": {
        "commands": [
            "ls",
            "pwd",
            "cd",
            "date",
            "df",
            "du",
            "reboot",
            "ifconfig",
            "netstat",
            "ping",
            "ps"
        ]
    },
    "message": "OK",
    "result": 0
}

把Response结果的 commands 展示在web界面上，属于所有支持的�命令,
KEY 为 index
Value 为 name
get_commands 的列表，后台修改后，会导致变化，表现的结果就是hash值不一样。

3.11.2. 执行命令

POST
URL : /v1/run_command
Body

{
	"token":"da5fddbb-19b4-4397-abdd-ce986e260165",
	"data":{
		"command": "ping",
		"params": " -c 4    127.0.0.1 "
	}
}

Response

{
    "data": {
        "output": "PING 127.0.0.1 (127.0.0.1) 56(84) bytes of data.\n64 bytes from 127.0.0.1: icmp_seq=1 ttl=64 time=0.046 ms\n64 bytes from 127.0.0.1: icmp_seq=2 ttl=64 time=0.031 ms\n64 bytes from 127.0.0.1: icmp_seq=3 ttl=64 time=0.033 ms\n64 bytes from 127.0.0.1: icmp_seq=4 ttl=64 time=0.036 ms\n\n--- 127.0.0.1 ping statistics ---\n4 packets transmitted, 4 received, 0% packet loss, time 2997ms\nrtt min/avg/max/mdev = 0.031/0.036/0.046/0.008 ms\n"
    },
    "message": "OK",
    "result": 0
}

command: 要执行的具体命令,这些命令必须存在于 get_command 的返回结果，否则不支持.
params 可以传递命令需要的相关参数

3.12. SNMP Server 配置

3.12.1. 获取配置

POST
URL : /v1/get_configure
Body :

{
	"token":"da5fddbb-19b4-4397-abdd-ce986e260165"
}

Response

{
    "data": {
        "configure": {
            "ntpd_enable": false,
            "ntp_server_1": "",
            "ntp_server_2": "",
            "web_port": 9192,
            "snmp_port": 162
        }
    },
    "message": "OK",
    "result": 0
}

3.12.2. 设置配置

POST
URl : /v1/set_configure
Body

configure 的字段为当前支持的配置项目，每个都提交

{
	"token":"e43a9e5c-a42a-4dc8-8524-11d483167243",
	"data": {
        "configure": {
            "ntpd_enable": false,
            "ntp_server_1": "",
            "ntp_server_2": "",
            "web_port": 9192,
            "snmp_port": 162
        }
    }
}

web_port,snmp_port 修改后，重启生效
Response 返回最新的配置信息

{
    "data": {
        "configure": {
            "ntpd_enable": false,
            "ntp_server_1": "",
            "ntp_server_2": "",
            "web_port": 9192,
            "snmp_port": 162
        }
    },
    "message": "OK",
    "result": 0
}

3.13. 告警

3.13.1. 获取告警

POST
URl : /v1/get_warnings
Body

3.13.2. 清除告警

POST
URl : /v1/clear_warning
Body

{
	"token":"e43a9e5c-a42a-4dc8-8524-11d483167243",
	"data": {
        "id":int
    }
}

3.14. 日志事件

用户	设备	事件	子事件	说明	状态
systen	server	start	start	软件启动	完成
system	server	stop	stop	软件退出	完成
user	NA	login	login	用户登录事件，记录登录IP	完成
user	NA	logout	logout	用户手动退出,记录登录IP，最后一次请求时间	完成
user	NA	logout	timeout	用户超时退出	完成
user	NA	upload	terminal	终端软件上传，记录上传文件名称	完成，但未记录user
user	NA	update	system	系统软件升级	完成，但未记录user
user	NA	config	set_config	系统配置,记录配置信息	完成
ntp	NA	ntp	sync_err	ntp同步失败,记录失败的原因	完成
ntp	NA	ntp	sync_ok	ntp同步从失败切换到成功	完成
user	ntid	snmp	set_ok	snmp配置成功，记录下发配置的内容	完成
user	ntid	snmp	set_err	snmp配置失败，记录失败的原因.	完成
system	ntid	warning_occur	warning_type	告警发生记录 warning demo	完成
system	ntid	warning_clear	warning_type	告警自动清除，记录 warning demo	完成
user	ntid	warning_clear	warning_type	告警手动清除	完成
system	ntid	status	online	设备从 offline--> online 事件	完成
system	ntid	status	offline	设备从 online--> offline 事件	完成
system	ntid	status	create	设备初始化，创建	完成
user	NA	runcommand	command	params	完成

warningType : callout,camera,keyp,lcd,led,mic,quick,shell,speaker,drycontact,power,register,backup_net_drop,backup_power_drop,main_backup_switch,main_net_drop,ntp_drop,main_power_drop,recording_fail, usual_input_1,usual_input_2,usual_input_3,usual_input_4,usual_input_5,usual_input_6,usual_input_7,usual_input_8,usual_input_9,usual_input_10

3.14.1. 日志查询接口

POST
URL :/v1/get_logs
BODY

{
	"token":"470db58e-f42b-432f-9118-44062938b202",
	"data":
	{
		"wheres":{
			"time_start":"2019-03-01 00:00:00",
			 "time_end": "2019-03-03 00:00:00",
			 "username": ["admin"],
			 "ntid": ["NA"],
			 "event":"logout",
			 "sub_event": "timeout"
		},
		"index":1,
		"size": 20
	}
}

wheres 条件中的 time_start, time_end 至少要包含一个，如果同时包含，必须相同年月，不允许跨月查询
username,ntid,event,sub_event 属于可选字段，传递 "" 字符忽略相关字段
index 和 size 用于分页查询
- index 表示第几页，起始页面从1开始，不存在第0页
- size 每页的大小
Response

{
    "data": {
        "counts":35,
        "logs": [
            {
                "id": 11,
                "username": "admin",
                "ntid": "NA",
                "event": "logout",
                "sub_event": "timeout",
                "timestamp": "2019-03-02T01:42:43+08:00",
                "info": "last:0001-01-01 00:00:00, token:853c992a-c32c-47ef-ad45-70740b486a37"
            },
            {
                "id": 15,
                "username": "admin",
                "ntid": "NA",
                "event": "logout",
                "sub_event": "timeout",
                "timestamp": "2019-03-02T01:46:15+08:00",
                "info": "last:0001-01-01 00:00:00, token:470db58e-f42b-432f-9118-44062938b202"
            },
            {
                "id": 19,
                "username": "admin",
                "ntid": "NA",
                "event": "logout",
                "sub_event": "timeout",
                "timestamp": "2019-03-02T01:56:02+08:00",
                "info": "last:2019-03-02 01:55:02, token:21fdc34d-c272-489a-b39e-8d5d5cc63b94"
            },
            {
                "id": 23,
                "username": "admin",
                "ntid": "NA",
                "event": "logout",
                "sub_event": "timeout",
                "timestamp": "2019-03-02T11:41:16+08:00",
                "info": "last:2019-03-02 11:40:16, token:a377d106-0eee-4497-94cf-7d4bb33082cc"
            }
        ]
    },
    "message": "OK",
    "result": 0
}

counts 表示根据查询条件，得到的总数，不是当前返回的个数

3.14.2. 辅助查询转换接口

17.2.1. 获取所有用户列表

POST
URL : /v1/get_all_users
Body

{
	"token":"2478db70-485f-4a57-a2ed-b7e9395f4fdb"
}

Response

{
    "data": {
        "usernames": [
            "system",
            "ntp",
            "admin",
            "joey1",
            "joey6",
            "jame"
        ]
    },
    "message": "OK",
    "result": 0
}

17.2.2. 获取所有设备列表

POST
URL : /v1/get_all_terminals
Body

{
	"token":"2478db70-485f-4a57-a2ed-b7e9395f4fdb"
}

Response

{
    "data": {
        "root.guangzhou.liwang.debug-518-100": "00a859000b01",
        "root.shenzheng.bao.debug-200": "0a85901851",
        "root.shenzheng.bao.debug-300": "00a859001bc4",
        "root.shenzheng.bao.debug-400": "00a859000a07",
        "root.shenzheng.bao.debug-518-200": "00a859001851",
        "root.shenzheng.bao.debug-519-100": "00a859001ad3",
        "root.shenzheng.bao.debug-519-300": "00a859002d26",
        "root.shenzheng.longhua.test518-0": "5489079b8a0d"
    },
    "message": "OK",
    "result": 0
}

3.15. 系统自检

POST
URL : /v1/system_check
Body

{
	"token":"58bc9272-4f5d-4982-b5dc-b215813b83af"
}

Response

{
    "data": {
        "cpu_percent": "0.352571 %",
        "disk_free": "194 G",
        "disk_status": true,
        "memory_percent": "0.430870 %",
        "net_status": true,
        "run_time": "0.018717 hours",
        "start_time": "2019-03-02 16:33:00"
    },
    "message": "OK",
    "result": 0
}

3.16. 图片上传接口

FROM 表单
参数 file 为上传的文件input名称
URL : /v1/upload_image
返回值：成功返回图片的url相对路径，失败时返回 err:具体错误信息
- 因此判断返回是字符串是否为err开头，如果以err开头，说明上传失败，
参考 html表单

<!doctype html>
	<html lang="en">
	<head>
		<meta charset="utf-8">
		<title>Single image file upload</title>
	</head>
	<body>
	<h1>Upload single file with fields</h1>
	
	<form action="/v1/upload_image" method="post" enctype="multipart/form-data">
		Files: <input type="file" name="file"><br><br>
		<input type="submit" value="Submit">
	</form>
	</body>

Name		Name	Last commit message	Last commit date
Latest commit History 41 Commits
bin		bin
src		src
.gitignore		.gitignore
delete.sh		delete.sh
get.sh		get.sh
readme.md		readme.md
snmp_api_test.rest		snmp_api_test.rest

newzai/snmp

Folders and files

Latest commit

History

Repository files navigation

API接口

1. build

2. 内嵌web

2.1. dist.zip

2.2. build 内嵌资源 asset.go 文件

2.3. go-bindata 安装 (执行一次即可)

3. HTTP 接口

3.1. common

3.1.1. userinfo

3.1.2. iteminfo

3.2. login

3.3. logout

3.4. getitem

3.5. set_item 设置区域或者设备属性

3.6. SNMP 配置

3.6.1. 获取配置文件

3.7. SNMP 批量配置

3.7.1. 批量FTP升级

3.7.2. 批量重启

3.7.3. 批量恢复出厂设置

3.7.4. 批量备份配置文件

3.7.5. 批量配置

3.8. SNMP系统用户管理

3.8.1. modify_password 修改自己的用户名和密码

3.8.2. getusers -- for admin

3.8.3. create_user -- for admin

3.8.4. delete_user -- for admin

3.8.5. modify_user -- for admin

3.9. 固件管理 -- for admin

3.9.1. 固件查询

3.9.2. 固件上传

3.10. FTP 固件升级

3.10.1. ftp 升级

3.10.2. ftp 升级状态查询

3.11. linux 命令

3.11.1. 获取命令列接口

3.11.2. 执行命令

3.12. SNMP Server 配置

3.12.1. 获取配置

3.12.2. 设置配置

3.13. 告警

3.13.1. 获取告警

3.13.2. 清除告警

3.14. 日志事件

3.14.1. 日志查询接口

3.14.2. 辅助查询转换接口

17.2.1. 获取所有用户列表

17.2.2. 获取所有设备列表

3.15. 系统自检

3.16. 图片上传接口

About

Resources

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages