Docs认证 (Auth)
认证 (Authentication)
所有需要认证的 FindIP API 请求都必须在 X-API-Key 请求头中携带 API 密钥。
API 密钥格式
API 密钥格式为 psk_live_xxxxxxxxxxxxxxxx。API 密钥可通过联系我们获取。
注意
请妥善保管 API 密钥。不要暴露在客户端代码、公开仓库或浏览器请求中。请使用服务器环境变量或服务器端代理。
发送已认证请求
将 API 密钥放入 X-API-Key 请求头(不使用 Bearer 前缀)。
cURL
curl -X POST https://api.findip.ai/api/v1/search/semantic \
-H "X-API-Key: psk_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{"query": "semiconductor etching process", "top_k": 5}'Python
import requests
response = requests.post(
"https://api.findip.ai/api/v1/search/semantic",
headers={
"X-API-Key": "psk_live_your_api_key",
"Content-Type": "application/json",
},
json={
"query": "semiconductor etching process",
"top_k": 5,
},
)
data = response.json()JavaScript (Node.js)
const response = await fetch("https://api.findip.ai/api/v1/search/semantic", {
method: "POST",
headers: {
"X-API-Key": "psk_live_your_api_key",
"Content-Type": "application/json",
},
body: JSON.stringify({
query: "semiconductor etching process",
top_k: 5,
}),
});
const data = await response.json();公开端点
GET /api/v1/drawings/...、GET /api/v1/stats/coverage 以及健康检查无需 X-API-Key 请求头。
请求限额 (Rate Limiting)
检索调用从订阅套餐的月度额度中扣除。详情·附图·编号查询不计入额度。超过额度时 API 将返回 429 Too Many Requests。所有调用还另有每分钟 60 次的速率限制。
| 套餐 | 每月检索额度 |
|---|---|
| 免费 (Free) | 每月 30 次 |
| 基础 (Basic) | 每月 300 次 |
| 专业 (Pro) | 每月 1,000 次 |
| 企业 | 另行协商 |
密钥管理
在仪表盘中可方便地管理 API 密钥。
- 按环境（开发、生产）发行多个密钥
- 立即吊销（Revoke）泄露的密钥
- 监控每个密钥的使用量和请求日志