本文目录

API调用概述

接口地址

如果你还没有HTTP接口地址,可以先在API节点中添加一个,请参考 API节点设置

注意:这里说的HTTP接口地址不是GRPC地址,也不是管理系统地址。

如果想调用某个具体的方法,那么地址就是:

API接口地址/服务名/方法名
比如:
http://192.168.2.100/ServerService/createServer

调用方法

除了 /APIAccessTokenService/getAPIAccessToken 接口外,其他的所有接口都需要:

  1. 在HTTP Header中传递X-Edge-Access-Token令牌数据,以便于我们认证用户是否有接口访问的权限,此令牌通过 /APIAccessTokenService/getAPIAccessToken 接口获取,具体请参考 认证 一节。
  2. 所有请求数据需要以 POST 方法上传一个完整的JSON数据,接口响应数据也是JSON数据

比如:

POST /HTTPAccessLogService/listHTTPAccessLogs
...
X-Edge-Access-Token: n8adDybtPCAGdbORkXjfpJgL28EGkOLz
...

{
	"serverId": 23,
	"day": "20210101",
	"size": 100,
	"reverse": true
}

可以在这里查看令牌获取方法。

CURL示例

curl -v -XPOST -H"X-Edge-Access-Token: hZFW3yg1geeKYqLPjhmi5OyAtYoKingiNoemNkqjLWIsCXJcmaHDaUL1ELX6vtPrjvwiXiTuBN9mAVK8cUhn6PpuN1eLYbtN1seAFMpf2h6aZtFgkhAxI3cYUSZIwLQg"  "http://192.168.1.6:8004/HTTPAccessLogService/listHTTPAccessLogs" -d '{
  "size":100, 
  "day":"20211217"
}'
你需要把IP地址、X-Edge-Access-Token换成你自己的。

格式化输出

可以在HTTP Header中增加 X-Edge-Response-Pretty: on 来让输出的JSON更加可读。

HTTP状态码

调用API后,一定 要检查API响应的HTTP状态码(注意是HTTP状态码,不是JSON里面的code),只有200才是响应成功,以下是常见的几种响应状态码错误:

  • 400 - 错误的请求格式(可能是发送的内容过大、或JSON数据格式错误)
  • 404 - API服务或方法不存在,或错误的API路径

常见问题

调用API的时候提示 Received HTTP/0.9 when not allowed 是怎么回事?

答:你没有按照本文开头部分所说的添加HTTP接口地址,请 点击这里 添加HTTP接口地址后再重试。

GoEdge文档