通用说明
请求地址
| 环境 | Base URL |
|---|---|
| 标准接口 | https://standard.data-api.skyviewor.host |
通用响应格式
所有接口(含错误)均返回 JSON,结构如下:
{
"code": 0,
"message": "ok",
"data": {},
"request_id": "req_a1b2c3d4e5f6"
}
| 字段 | 类型 | 说明 |
|---|---|---|
code |
int | 0 表示成功;非 0 表示失败 |
message |
string | "ok" 或错误描述 |
data |
object | 成功时的业务数据;失败时为 null |
request_id |
string | 本次请求的唯一追踪 ID(可用于排查问题) |
健康检查
概览
| 项目 | 内容 |
|---|---|
| 方法 | GET |
| 路径 | https://standard.data-api.skyviewor.host/v1/health |
| 鉴权 | 不需要 |
| 定价 | 免费 |
响应示例
{
"code": 0,
"message": "ok",
"data": {
"status": "ok",
"service": "data-api"
},
"request_id": "req_a1b2c3d4e5f6"
}
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
data.status |
string | 服务状态,正常为 "ok" |
data.service |
string | 服务名称,固定 "data-api" |
代码示例
curl -s https://standard.data-api.skyviewor.host/v1/health
import json, urllib.request
req = urllib.request.Request("https://standard.data-api.skyviewor.host/v1/health")
with urllib.request.urlopen(req, timeout=10) as resp:
result = json.loads(resp.read().decode())
print(result["data"]["status"]) # "ok"
const resp = await fetch("https://standard.data-api.skyviewor.host/v1/health");
const result = await resp.json();
console.log(result.data.status); // "ok"
const resp = await fetch("https://standard.data-api.skyviewor.host/v1/health");
const result: any = await resp.json();
console.log(result.data.status); // "ok"
resp, _ := http.Get("https://standard.data-api.skyviewor.host/v1/health")
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
HttpClient client = HttpClient.newHttpClient();
HttpRequest req = HttpRequest.newBuilder()
.uri(URI.create("https://standard.data-api.skyviewor.host/v1/health"))
.GET().build();
HttpResponse<String> resp = client.send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());
using var client = new HttpClient();
var json = await client.GetStringAsync("https://standard.data-api.skyviewor.host/v1/health");
using var doc = JsonDocument.Parse(json);
Console.WriteLine(doc.RootElement.GetProperty("data").GetProperty("status").GetString());
$ch = curl_init("https://standard.data-api.skyviewor.host/v1/health");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
echo "status: " . $result['data']['status'] . "\n";
library(httr)
library(jsonlite)
resp <- GET("https://standard.data-api.skyviewor.host/v1/health")
result <- fromJSON(content(resp, "text", encoding = "UTF-8"))
cat(sprintf("status: %s\n", result$data$status))
result = webread('https://standard.data-api.skyviewor.host/v1/health');
fprintf('status: %s\n', result.data.status);