🐝Novidade: bots de IA que fazem suas tarefasSaiba mais →
Programadores

Construa com a BusyBee.Day

Integre agendamento inteligente nas suas aplicações via REST API e webhooks.

ComeçarLer documentação
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);

Recursos para programadores

Documentação API

Referência REST API para tarefas, projetos, hábitos e agendamento

Autenticação

Autenticação baseada em JWT para acesso à API

Início rápido

Crie a sua primeira tarefa e projeto via API em 5 minutos

Webhooks

Webhooks de entrada e saída com 11+ tipos de eventos e mapeamento de campos

Referência API

Endpoints para tarefas, projetos, hábitos, tempo de foco, webhooks e mais

Exemplos de integração

Cargas de exemplo de webhooks e padrões de integração

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.

O que pode construir

• Integrações de agendamento personalizadas
• Dashboards de analytics de calendário
• Ferramentas de disponibilidade de equipa
• Fluxos de reserva automatizados
• Aplicações de tracking de tempo de foco
• Ferramentas de otimização de reuniões

Precisa de ajuda?

A nossa equipa de suporte para programadores está aqui para o ajudar a construir.

Contactar suporte para programadores →