API概述
量子幻海技术API提供了一套完整的接口，用于与我们的产品和服务进行集成。所有API请求都通过HTTPS进行，并返回JSON格式的数据。
基础URL
https://api.fuint.cn/v1
请求格式
所有请求都需要在HTTP头中包含以下信息：
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN
响应格式
所有响应都遵循以下结构：
{
"success": true,
"data": {},
"message": "请求成功",
"error": null,
"timestamp": "2023-05-15T10:30:00Z"
}
认证
所有API调用都需要认证。我们使用Bearer Token方式进行认证。您可以在账户设置页面获取您的API密钥。
获取访问令牌
POST /auth/token
{
"client_id": "your_client_id",
"client_secret": "your_client_secret",
"grant_type": "client_credentials"
}
使用访问令牌
GET /users
Authorization: Bearer YOUR_ACCESS_TOKEN
错误处理
API使用标准HTTP状态码来指示请求的成功或失败。错误响应将包含错误代码和描述。
| 状态码 |
含义 |
| 200 |
请求成功 |
| 400 |
请求参数错误 |
| 401 |
认证失败 |
| 403 |
权限不足 |
| 404 |
资源不存在 |
| 429 |
请求过于频繁 |
| 500 |
服务器错误 |