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/projectsRetourne 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/projectsCré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}/refineEnvoyez 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}/conversationsRetourne l'historique complet des conversations, y compris les marqueurs de déploiement et les messages en attente.
Parcourir la bibliothèque
GET /api/v1/libraryParamètres de requête :
botType— Filtrer par type (site, app, bot, api, internal)search— Rechercher par nom ou descriptionsort—newest(par défaut) oupopularpage— 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.