Babrababra返回首页

Babra AI 开发者与 Agent API

Babra AI 提供公开 REST API、OpenAPI 3.1 规范和 MCP 服务器，让 AI agent 可以读取产品数据；在申请人授权后，也可以读取其本人的申请数据。

公开 API

以下接口无需认证，每个客户端每分钟限 60 次请求。

  • GET /api/v1/status
  • GET /api/v1/capabilities
  • GET /api/v1/changelog
  • GET /api/v1/catalog/stats
  • GET /api/v1/catalog/taxonomy

OpenAPI 规范

完整接口由一份 OpenAPI 3.1 文档描述。

https://babra.ai/openapi.json

MCP 服务器

Model Context Protocol 端点使用 Streamable HTTP 传输。公开工具无需认证；读取申请人本人数据的工具需要 OAuth access token。

https://babra.ai/mcp

OAuth 2.1

授权采用 OAuth 2.1 authorization code + PKCE 流程，支持动态客户端注册。所有 scope 均为只读。

https://babra.ai/.well-known/oauth-authorization-server

Scope

  • profile:read 读取当前登录申请人的基本档案
  • programs:read 读取当前登录申请人的选校列表
  • materials:read 读取当前登录申请人的材料清单状态

速率限制

未认证请求按客户端 IP 限流：公开 API 与 MCP 端点每分钟 60 次，OAuth 授权、令牌、撤销端点每分钟 30 次，客户端注册每分钟 20 次。响应会带上 RateLimit-Limit、RateLimit-Remaining 和 RateLimit-Reset 头；GET /api/v1/capabilities 会返回各端点的当前限额。

支持

关于 agent 集成的问题请联系 siding@babra.ai。