API REST · Authentification par token personnel

API publique FloTask

Connectez FloTask à vos outils. 8 endpoints REST, JSON in/out, authentification par token Bearer.

1. Authentification

Générez votre token depuis votre profil. Format - Bearer dans le header Authorization.

2. Appelez l'API

REST sur HTTPS, JSON in/out, méthodes HTTP standards. CORS activé.

3. Intégrez

Scripts maison, Zapier, Make, n8n ou scripts externes. Tout en JSON.

Authentification

Comment s'authentifier

Toutes les requêtes doivent inclure votre token API dans le header Authorization au format Bearer. Le token se génère depuis votre profil utilisateur dans l'application.

curl -H "Authorization: Bearer votre_token_api" \
     https://flotask.vebeyx.com/app/taskflow/api_v1.php/workspaces
🔒
Sécurité : votre token API est affiché une seule fois à la création. Stockez-le dans un gestionnaire de secrets (1Password, Vault, AWS Secrets Manager). En cas de fuite, révoquez-le et régénérez-en un nouveau depuis votre profil.
URL de base

Point d'entrée

Toutes les ressources sont accessibles depuis l'URL de base :

https://flotask.vebeyx.com/app/taskflow/api_v1.php

Le suffixe de la ressource détermine l'action - /workspaces, /projects, /projects/{id}/tasks, etc. CORS est activé sur tous les endpoints.

Endpoints

Référence des endpoints

L'API expose 8 endpoints. Cliquez sur un endpoint pour voir les détails (paramètres, réponse, exemples).

GET /workspaces
Description

Liste tous les workspaces dont vous êtes membre.

Réponse
{
  "data": [
    {
      "id": 1,
      "name": "Mon workspace",
      "owner_id": 42,
      "created_at": "2026-01-15 10:30:00"
    }
  ],
  "success": true
}
GET /projects
Description

Liste tous les projets actifs accessibles par le token.

Réponse
{
  "data": [
    {
      "id": 12,
      "name": "Refonte site Vebeyx",
      "workspace_id": 1,
      "status": "active",
      "created_at": "2026-02-03 14:22:00"
    }
  ],
  "success": true
}
GET /projects/{id}
Description

Récupère le détail d'un projet.

Paramètres URL
  • id : identifiant numérique du projet
Sous-ressources accessibles
  • /projects/{id}/tasks : tâches du projet
  • /projects/{id}/groups - groupes/colonnes du projet
GET /projects/{id}/tasks
Description

Liste les tâches actives d'un projet (non archivées).

Réponse
{
  "data": [
    {
      "id": 482,
      "name": "Préparer la maquette",
      "description": "Wireframes desktop + mobile",
      "status": "todo",
      "priority": "high",
      "due_date": "2026-07-25",
      "assignee_name": "Valentin Bonnin",
      "project_id": 12,
      "group_id": 3,
      "archived": 0,
      "created_at": "2026-07-10 09:15:00"
    }
  ],
  "success": true
}
POST /projects/{id}/tasks
Description

Crée une nouvelle tâche dans le projet.

Corps de la requête (JSON)
{
  "name": "Préparer la maquette",
  "description": "Wireframes desktop + mobile",
  "priority": "high",
  "due_date": "2026-07-25",
  "group_id": 3
}

Si group_id n'est pas fourni, la tâche est créée dans le premier groupe du projet.

Codes de retour
  • 201 Created : tâche créée
  • 400 Bad Request : champ name manquant
  • 401 Unauthorized : token manquant ou invalide
  • 403 Forbidden - accès refusé à ce projet
GET /tasks/{id}
Description

Récupère le détail d'une tâche.

PUT /tasks/{id}
Description

Met à jour une tâche. Seuls les champs envoyés dans le JSON sont modifiés (PATCH-like).

Corps de la requête (JSON)
{
  "status": "done",
  "priority": "low"
}

Tous les champs de la tâche sont modifiables : name, description, status, priority, due_date, assignee_id, group_id, archived.

DELETE /tasks/{id}
Description

Supprime définitivement une tâche. Action irréversible.

Exemples

Cas d'usage concrets

Créer une tâche depuis un formulaire de contact

curl -X POST \
     -H "Authorization: Bearer votre_token" \
     -H "Content-Type: application/json" \
     -d '{"name":"Nouveau lead depuis site web","priority":"high"}' \
     https://flotask.vebeyx.com/app/taskflow/api_v1.php/projects/12/tasks

Lister les tâches en retard

curl -H "Authorization: Bearer votre_token" \
     https://flotask.vebeyx.com/app/taskflow/api_v1.php/projects/12/tasks \
   | jq '.data[] | select(.due_date < "2026-07-15" and .status != "done")'

Marquer une tâche comme terminée

curl -X PUT \
     -H "Authorization: Bearer votre_token" \
     -H "Content-Type: application/json" \
     -d '{"status":"done"}' \
     https://flotask.vebeyx.com/app/taskflow/api_v1.php/tasks/482
CORS

Appels depuis un navigateur

L'API expose les headers CORS suivants, ce qui permet de l'appeler depuis n'importe quelle origine :

Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS
Access-Control-Allow-Headers: Authorization, Content-Type

Les requêtes OPTIONS (preflight) renvoient un statut 200 sans traitement.

Une question sur l'API ?

Notre équipe technique vous répond sous 24h.

Contacter le support