REST + JSON · 令牌认证 · OpenAPI 3

SprintFlint API。
对于特工和人类。

以编程方式访问项目、冲刺、工单和评论。 REST 端点、JSON 有效负载、令牌身份验证和 OpenAPI 3 规范。专为 AI 编码代理（Cursor、Claude Code、Codex）和想要编写冲刺工作流程脚本的工程师而构建。

认证

每个请求都需要一个 Bearer 令牌。从您的帐户设置生成一个。令牌的范围仅限于您的组织且可撤销。

Authorization: Bearer YOUR_TOKEN
Accept: application/json
Content-Type: application/json

快速启动

用四行代码列出您的项目。选择与您的堆栈相匹配的示例。

卷曲

curl https://sprintflint.com/api/v1/projects \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

红宝石

require 'net/http'
require 'json'

uri = URI('https://sprintflint.com/api/v1/projects')
req = Net::HTTP::Get.new(uri)
req['Authorization'] = 'Bearer YOUR_TOKEN'
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts JSON.parse(res.body)

蟒蛇

import requests

r = requests.get(
    'https://sprintflint.com/api/v1/projects',
    headers={'Authorization': 'Bearer YOUR_TOKEN'}
)
print(r.json())

节点

const res = await fetch('https://sprintflint.com/api/v1/projects', {
  headers: { Authorization: 'Bearer YOUR_TOKEN' }
});
const data = await res.json();
console.log(data);

资源模型

所有核心资源都具有一致的 CRUD 语义。

项目

顶级容器。 GET /api/v1/projects 列出您组织中的所有项目。使用匹配的动词创建、更新、删除。

冲刺

项目中按时间限制的迭代。 POST /api/v1/projects/:id/sprints/:id/activation 开始冲刺。 /completion 结束它。

工单（票）

工作单位。生活在冲刺中。 Markdown 中的状态、故事点、受让人、标签和自由格式描述。

每票对话线程。 AI 代理可以发布状态更新、链接 PR 或表面拦截器，而无需离开编辑器。

对于AI编码代理

SprintFlint 被设计为可由 AI 代理读取和操作。公共表面：

`mcp.sprintflint.com`

实时 MCP 服务器（模型上下文协议）。从 Claude Desktop、Claude Code、Cursor 或任何 MCP 兼容客户端进行连接，以从编辑器内部读取工单、创建工单、推进冲刺和查询速率。不记名令牌授权，MCP 2025-06-18。

`/api-docs/v1/swagger.yaml`

OpenAPI 3 规范。放入 Cursor、Claude Code 或任何使用 OpenAPI 的代理。身份验证、模式、示例；都在那里。

30秒连接Claude Desktop

在您的 Claude Desktop 配置中添加 SprintFlint 作为 MCP 服务器，您可以要求 Claude 提前冲刺、得分速率或开票，而无需离开对话。

{
  "mcpServers": {
    "sprintflint": {
      "url": "https://mcp.sprintflint.com/",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

获取 YOUR_TOKEN 来自账户设置。与 REST API 相同。

使用不同的编辑器？的 MCP 配置生成器也为 Cursor、Claude Code 和 Zed 发出可粘贴的片段。

速率限制和约定

基本网址： https://sprintflint.com/api/v1
授权： Authorization: Bearer YOUR_TOKEN
格式： JSON 请求和响应。 Content-Type: application/json 写入时。
错误： 标准 HTTP 状态代码。身体是 { "error": "human-readable message" } 4xx/5xx。
分页： ?page=N&per_page=M 在收集端点上。 per_page 默认为 25，最大 100。
速率限制： 600 个请求/分钟/令牌。 429 超过与 Retry-After 标头。

使用 API 构建一些东西

冲刺仪表板、自定义报告、从 Linear 或 Jira 自动导入、Slack 机器人、AI 代理。免费计划包含 API 访问权限；无需信用卡，也没有追加销售。

免费开始，每月 50 个工单浏览完整规格

SprintFlint API。 对于特工和人类。

认证