AI 快速对接

推荐调用流程

1. 调用 GET /health 判断服务是否可用。
2. 调用 POST /images 写入单条图片 URL。
3. 调用 GET /images?after_id=0 读取第一页数据。
4. 调用 GET /admin/token?key=YOUR_KEY 获取管理员 token。
5. 使用 token 调用删除或备份配置接口。

最小接口契约

GET /health
POST /images
GET /images?after_id=0
GET /admin/token?key=YOUR_SECRET_KEY
POST /admin/images/delete
POST /admin/backup

{
  "upload": { "url": "https://example.com/a.jpg" },
  "delete": { "token": "ADMIN_TOKEN", "id": 1 }
}

错误处理

错误响应通常为 { "error": "message" }。AI Agent 应按 HTTP 状态码决定是否重试、刷新 token 或交给人工处理。

JavaScript 示例

const baseUrl = 'http://127.0.0.1:3000';

async function uploadImage(url) {
  const response = await fetch(`${baseUrl}/images`, {
    method: 'POST',
    headers: { 'content-type': 'application/json' },
    body: JSON.stringify({ url }),
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}