🐝Nouveau : des bots IA qui font vos tâchesEn savoir plus →
Développeurs

Construisez avec BusyBee.Day

Intégrez la planification intelligente dans vos applications avec notre API REST et nos webhooks.

CommencerLire la doc
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);

Ressources développeurs

Documentation API

Référence de l'API REST pour tâches, projets, habitudes et planification

Authentification

Authentification basée sur JWT pour l'accès API

Guide démarrage rapide

Créez votre première tâche et projet via l'API en 5 minutes

Webhooks

Webhooks entrants et sortants avec 11+ types d'événements et mapping de champs

Référence API

Endpoints pour tâches, projets, habitudes, temps de focus, webhooks et plus

Exemples d'intégration

Exemples de payloads webhook et patterns d'intégration

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.

Ce que vous pouvez construire

• Intégrations de planification personnalisées
• Tableaux de bord d'analyse calendrier
• Outils de disponibilité d'équipe
• Workflows de réservation automatisés
• Apps de suivi du temps de focus
• Outils d'optimisation de réunions

Besoin d'aide ?

Notre équipe support développeurs est là pour vous aider à construire.

Contacter le support développeurs →