222 API文档 - 吾侪API数据库

概述

提示：在使用API之前，请先注册账号并获取API密钥。

认证方式

本API采用API Key + Secret的认证方式，需要在请求头中携带以下字段：

Header名称	说明	示例
`X-API-Key`	API密钥	`ak_xxxxxxxxxxxx`
`X-API-Secret`	API密钥密文	`sk_xxxxxxxxxxxx`

API端点

GET

http://wuchai.net/api/v1/ai/api

请求参数

Header参数

参数名	类型	必填	说明
`X-API-Key`	string	是	API密钥
`X-API-Secret`	string	是	API密钥密文

Query参数

具体业务参数请根据实际需求传递，常见参数包括：

param1 - 参数1说明
param2 - 参数2说明

调用示例

cURL

curl -X GET \
  "http://wuchai.net/api/v1/ai/api" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"

JavaScript (Axios)

const axios = require('axios');

const response = await axios({
  method: 'get',
  url: 'http://wuchai.net/api/v1/ai/api',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'X-API-Secret': 'YOUR_API_SECRET'
  }
});

console.log(response.data);

Python

import requests

response = requests.get(
    'http://wuchai.net/api/v1/ai/api',
    headers={
        'X-API-Key': 'YOUR_API_KEY',
        'X-API-Secret': 'YOUR_API_SECRET'
    }
)

print(response.json())

响应格式

成功响应

{
  "success": true,
  "data": {
    // 业务数据
  },
  "meta": {
    "request_id": "req_xxxxxx",
    "response_time": 0.123
  }
}

字段说明

字段	类型	说明
`success`	boolean	请求是否成功
`data`	object	业务数据
`meta.request_id`	string	请求ID，用于问题排查
`meta.response_time`	number	响应时间（秒）

错误码

错误码	HTTP状态	说明
`MISSING_API_KEY`	401	缺少API密钥
`INVALID_API_KEY`	401	无效的API密钥
`INVALID_API_SECRET`	401	API密钥错误
`API_KEY_DISABLED`	403	API密钥已禁用
`API_KEY_EXPIRED`	403	API密钥已过期
`DAILY_QUOTA_EXCEEDED`	429	超出每日配额
`RATE_LIMIT_EXCEEDED`	429	速率限制超限
`SERVICE_NOT_FOUND`	404	服务不存在
`SERVICE_ERROR`	500	服务处理失败

限制说明

速率限制

默认每分钟60次请求，可根据套餐调整

每日配额

根据套餐不同，每日可调用100-10000次

并发限制

同一密钥最多10个并发请求

超时时间

请求超时时间为30秒