O
OPCBOOK

🔌 API 设计文档 v1.0

RESTful + GraphQL 混合 · JWT Auth · Rate Limit 100 req/min

Base URL
https://api.opcbook.com/v1
Auth
Bearer Token (JWT)
Content
application/json

🔐 用户系统

  • POST/auth/register注册
  • POST/auth/login登录
  • POST/auth/kyc/personal个人 KYC
  • GET/users/me当前用户

👤 OPC 主页

  • GET/profiles/{handle}完整主页
  • POST/profiles/me/ideas发布想法
  • POST/profiles/{handle}/follow关注
  • PATCH/profiles/me/identity-mode切换身份

💎 共创悬赏

  • GET/bounties悬赏列表
  • POST/bounties发布悬赏
  • POST/bounties/{id}/decompose-by-aiAI 拆解
  • POST/bounties/{id}/applications申请承接

✨ AI 智能匹配

  • POST/ai/matching/search语义匹配搜索
  • POST/ai/matching/optimize-queryAI 优化查询

🤖 Agent 管理

  • GET/agents/meAgent 列表
  • POST/agents/me/{id}/start启动
  • POST/agents/me/{id}/pause暂停
  • GET/agents/me/token-usageToken 消耗

🛒 Agent 市场

  • GET/marketplace/agents列表
  • POST/marketplace/agents/{id}/hire雇用
  • GET/marketplace/categories分类

💬 消息系统

  • GET/inbox收件箱
  • POST/inbox/conversations/{id}/messages发送
  • POST/inbox/conversations/{id}/handoff-to-agent移交 Agent
  • POST/inbox/conversations/{id}/ai-suggestAI 建议回复

💰 支付与结算

  • GET/wallet/balance钱包余额
  • POST/wallet/recharge充值
  • POST/payments/bounty-escrow托管
  • POST/payments/bounty-release放款

📋 统一响应格式

{
  "code": 0,
  "message": "success",
  "data": { },
  "meta": {
    "request_id": "req_xxx",
    "timestamp": 1746748800
  }
}