🐝新功能:替你完成任务的 AI 机器人了解更多 →
开发者

用 BusyBee.Day 构建

通过 REST API 和 Webhook 将智能调度集成到您的应用中。

example.js
// Create a task via the BusyBee.Day API
const response = await fetch('https://api.busybee.day/api/tasks', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_JWT_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    title: 'Review pull request',
    priority: 'P2',
    due_date: '2026-04-01',
    duration: 30,
    project_id: 'proj_abc123'
  })
});

const task = await response.json();
console.log(task);

开发者资源

API Overview

The BusyBee.Day API is a JSON REST API. The base URL is https://api.busybee.day. Every endpoint is prefixed with /api/. Requests and responses use UTF-8 JSON. All timestamps are ISO 8601 in UTC.

Authentication is via JWT bearer tokens. Rate limits are 600 requests per minute per token. Pagination uses page and page_size query parameters (max page size: 100).

Authentication

BusyBee.Day uses JWT bearer tokens. Obtain a token by calling /api/auth/login with your email and password. Pass the returned token in the Authorization header on every subsequent request.

auth.js
// 1. Log in to obtain a JWT
const { token } = await fetch('https://api.busybee.day/api/auth/login', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    email: '[email protected]',
    password: 'your-password'
  })
}).then(r => r.json());

// 2. Use the token in subsequent requests
const tasks = await fetch('https://api.busybee.day/api/tasks', {
  headers: { 'Authorization': `Bearer ${token}` }
}).then(r => r.json());

Quickstart

  1. Create an account at /register.
  2. Log in via the API to obtain a JWT (see Authentication above).
  3. Create your first project with POST /api/projects.
  4. Add tasks with POST /api/tasks, passing the project_id from step 3.
  5. Subscribe to events with POST /api/webhooks to be notified when tasks change.

Endpoint Reference

GET
/api/tasks
List tasks. Filter by project, priority, status, due_date, assignee.
POST
/api/tasks
Create a task. Supports priority (P1-P4), labels, custom fields.
PATCH
/api/tasks/{id}
Update any task field. Returns the patched task.
DELETE
/api/tasks/{id}
Soft-delete a task (recoverable from Trash for 30 days).
GET
/api/projects
List projects. Filter by team, layout, archived state.
POST
/api/projects
Create a project. Pick layout: list, table, board, calendar, timeline, gallery.
GET
/api/habits
List habits with streak counts and recurrence patterns.
POST
/api/habits
Create a habit with daily / weekly / custom recurrence.
GET
/api/focus-time
Read focus-time configuration: weekly goal, block sizes, preferences.
POST
/api/webhooks
Register an outgoing webhook (event subscription + signing secret).
POST
/api/ai/parse
Parse a natural-language string into a structured task draft.

Looking for a specific endpoint not listed? Reach out via Contact.

Integration Examples

Outgoing webhooks fire when tasks, projects, habits, or meetings change. Each delivery includes an HMAC-SHA256 signature so you can verify the payload came from BusyBee.Day.

webhook-payload.json
// Outgoing webhook payload (task.completed event)
{
  "event": "task.completed",
  "delivered_at": "2026-05-06T14:32:11Z",
  "data": {
    "id": "task_8f3a...",
    "title": "Review pull request",
    "priority": "P2",
    "project_id": "proj_abc123",
    "completed_at": "2026-05-06T14:32:10Z",
    "completed_by": "user_61d0..."
  }
}

// Verify signature header
// X-BusyBee-Signature: sha256=<hex>
// HMAC-SHA256(body, your_signing_secret)

Full webhook setup, event list, and JSON-path mapping for incoming payloads is documented at /integrations/webhooks.

您可以构建什么

• 自定义调度集成
• 日历分析仪表板
• 团队可用性工具
• 自动预订工作流
• 专注时间追踪应用
• 会议优化工具

需要帮助?

我们的开发者支持团队随时帮助您构建。

联系开发者支持 →