API 快速开始
InfluxDB 提供丰富的 API 和 客户端库，可与您的应用程序集成。使用流行工具如 Curl 和 Postman 快速测试 API 请求。
本节指导您使用最常用的API方法。
有关整个API的详细文档，请参见InfluxDB v2 API参考。
如果您需要使用 InfluxDB 2.7与 InfluxDB 1.x API 客户端和集成，请参阅 1.x 兼容性 API。
引导你的应用程序
对于大多数API请求，您需要至少提供您的InfluxDB URL和授权令牌（API令牌）。
安装 InfluxDB OSS v2.x 或升级到 一个 InfluxDB Cloud 帐户。
认证
InfluxDB使用API tokens来授权API请求。
在探索API之前，使用InfluxDB UI为您的应用程序创建初始API令牌。
在每个请求中将您的API令牌包含在
Authorization: Token YOUR_API_TOKENHTTP头中。
#######################################
# Use a token in the Authorization header
# to authenticate with the InfluxDB 2.x API.
#######################################
curl --get "http://localhost:8086/api/v2" \
--header "Authorization: Token YOUR_API_TOKEN" \
--header 'Content-type: application/json' \
--data-urlencode "db=mydb" \
--data-urlencode "q=SELECT * FROM cpu_usage"
/**
* Use a token in the Authorization header
* to authenticate with the InfluxDB 2.x API.
*/
const https = require('https');
function queryWithToken() {
const options = {
host: 'localhost:8086',
path: "/api/v2",
headers: {
'Authorization': 'Token YOUR_API_TOKEN',
'Content-type': 'application/json'
},
};
const request = https.get(options, (response) => {
let rawData = '';
response.on('data', () => {
response.on('data', (chunk) => { rawData += chunk; });
})
response.on('end', () => {
console.log(rawData);
})
});
request.end();
}
Postman 是另一个流行的 API 探索工具。看看如何 使用 Postman 发送认证请求。
桶 API
在写入数据之前，您需要在InfluxDB中创建一个存储桶。创建一个存储桶，使用HTTP请求到InfluxDB API /buckets 端点。
INFLUX_TOKEN=YOUR_API_TOKEN
INFLUX_ORG_ID=YOUR_ORG_ID
curl --request POST \
"http://localhost:8086/api/v2/buckets" \
--header "Authorization: Token ${INFLUX_TOKEN}" \
--header "Content-type: application/json" \
--data '{
"orgID": "'"${INFLUX_ORG_ID}"'",
"name": "iot-center",
"retentionRules": [
{
"type": "expire",
"everySeconds": 86400,
"shardGroupDurationSeconds": 0
}
]
}'
编写API
通过HTTP请求将数据写入InfluxDB，使用InfluxDB API /api/v2/write 端点。
查询API
从InfluxDB查询，使用HTTP请求到/api/v2/query端点。