Référence de l'API

Projets

Créez, listez, mettez à jour et gérez les projets via l'API.

Dernière mise à jour :

API Projets

Gérez vos projets FloopFloop de manière programmatique.

Lister les projets

GET /api/v1/projects

Retourne tous les projets appartenant à l'utilisateur authentifié.

Paramètres de requête :

  • teamId (optionnel) — Filtrer par espace de travail d'équipe
curl -X GET https://floopfloop.com/api/v1/projects \
  -H "Authorization: Bearer flp_your_key"

Créer un projet

POST /api/v1/projects

Crée un nouveau projet et démarre le pipeline de génération par IA.

Corps de la requête :

{
  "name": "My Project",          // required
  "subdomain": "my-project",     // required, lowercase
  "prompt": "Description...",    // required
  "botType": "app",              // optional: site, app, bot, api, internal
  "isAuthProtected": true,       // optional, default true
  "teamId": "uuid",              // optional, for team workspace
  "attachments": [               // optional
    {
      "key": "uploads/userId/fileId/file.png",
      "fileName": "file.png",
      "fileType": "image/png",
      "fileSize": 12345
    }
  ]
}

Réponse (201) :

{
  "data": {
    "project": { "id": "...", "name": "My Project", "status": "queued", ... },
    "deployment": { "id": "...", "version": 1, "status": "pending" }
  }
}

Obtenir un projet

GET /api/v1/projects/{projectId}

Retourne les détails d'un projet spécifique.

Mettre à jour un projet

PATCH /api/v1/projects/{projectId}

Corps de la requête (tous les champs sont optionnels) :

{
  "name": "New Name",
  "description": "Updated description",
  "isPublic": true,
  "isAuthProtected": false,
  "hasBranding": false
}

Archiver un projet

DELETE /api/v1/projects/{projectId}

Archive un projet et libère son sous-domaine. Les ressources AWS sont nettoyées en arrière-plan.

Affiner un projet

POST /api/v1/projects/{projectId}/refine

Envoyez des instructions de suivi pour modifier un projet en production.

{
  "message": "Add a contact form to the homepage",
  "codeEditOnly": false,         // optional, true for code-only edits (cheaper)
  "attachments": []              // optional
}

Si le projet est en cours de déploiement, le message sera mis en file d'attente et traité automatiquement une fois le déploiement en cours terminé.

Obtenir les conversations

GET /api/v1/projects/{projectId}/conversations

Retourne l'historique complet des conversations, y compris les marqueurs de déploiement et les messages en attente.

Parcourir la bibliothèque

GET /api/v1/library

Paramètres de requête :

  • botType — Filtrer par type (site, app, bot, api, internal)
  • search — Rechercher par nom ou description
  • sortnewest (par défaut) ou popular
  • page — Numéro de page (par défaut 1)
  • limit — Éléments par page (1-50, par défaut 20)

Cloner un projet de la bibliothèque

POST /api/v1/library/{projectId}/clone
{ "subdomain": "my-clone" }

Clone un projet public de la bibliothèque vers votre compte.