API REST

API Ibda

Intégrez Ibda dans vos applications et automatisez vos workflows métier

Générer un token API Doc interactive (Swagger)Voir les endpoints

Conçue pour les développeurs

Une API REST moderne, sécurisée et bien documentée pour intégrer toutes les fonctionnalités d'Ibda

RESTful

API REST standard avec JSON. Endpoints intuitifs et prévisibles pour toutes vos opérations CRUD.

Authentification par token

Sécurisée par tokens Bearer personnels (préfixe ibda_). Chaque requête est authentifiée et isolée à votre compte.

Réponses JSON

Toutes les réponses sont en JSON structuré avec des codes HTTP standards et messages d'erreur clairs.

Performante

Hébergée sur infrastructure Next.js Edge. Temps de réponse rapides et haute disponibilité.

Multi-tenant

Chaque utilisateur accède uniquement à ses propres données. Isolation complète des comptes.

Rate limiting

Protection contre les abus avec limitation du nombre de requêtes par minute.

Démarrage rapide

Commencez à utiliser l'API en quelques minutes

Générer un token API

Connectez-vous à votre compte, allez dans Paramètres → API, puis cliquez sur « Nouveau token ». Cochez les permissions nécessaires (lecture / écriture / suppression par ressource), choisissez une durée d'expiration (1 an par défaut), puis copiez le token (format ibda_xxx) — il n'est affiché qu'une seule fois.

ibda_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0

Faire un appel avec le token

Ajoutez le header Authorization: Bearer ibda_... à toutes vos requêtes.

curl https://app.ibda.fr/api/crm/contacts \
  -H "Authorization: Bearer ibda_xxxxxxxxxxxx"

Créer une ressource

Pour créer un contact, un devis ou une facture, faites un POST avec un body JSON.

curl -X POST https://app.ibda.fr/api/crm/contacts \
  -H "Authorization: Bearer ibda_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "Romain",
    "lastName": "Guivarch",
    "email": "romain@rg-event.fr",
    "phone": "+33612345678",
    "company": "R&G Event Tech"
  }'

Permissions par token

Chaque token a des permissions granulaires au formatressource:action. Si une permission manque, l'API renvoie 403.

Ressource	:read	:write	:delete
Contacts	`contacts:read`	`contacts:write`	`contacts:delete`
Projets / événements	`projects:read`	`projects:write`	`projects:delete`
Devis	`quotes:read`	`quotes:write`	`quotes:delete`
Factures	`invoices:read`	`invoices:write`	`invoices:delete`
Catalogue produits	`products:read`	`products:write`	`products:delete`

:read — Lister, consulter, exporter en CSV.

:write — Créer (POST) et modifier (PUT). Inclut aussi la restauration depuis la corbeille.

:delete — Suppression (déplace dans la corbeille pendant 30 jours).

Recommandation : donnez à chaque token uniquement les permissions dont il a besoin. Un script Make qui crée des contacts depuis un Typeform n'a besoin que de contacts:write. Évitez de cocher :delete sauf nécessité.

Limites par défaut

60 requêtes par minute par token (au-delà : 401)
Expiration par défaut : 1 an (modifiable lors de la création)
Audit log : chaque appel API est enregistré (90 jours de rétention)

Make, Zapier, n8n

Connectez Ibda à n'importe quel outil via les modules HTTP standards.

Exemple : créer un contact depuis Make

Dans Make, ajoutez le module HTTP → Make a request.
Renseignez les champs ci-dessous, en remplaçant ibda_xxx par votre token.
Mappez les champs dynamiques (firstName, email, etc.) depuis le module précédent du scénario.

URL       : https://app.ibda.fr/api/crm/contacts
Method    : POST
Headers   :
  Authorization  : Bearer ibda_xxxxxxxxxxxxxxxx
  Content-Type   : application/json
Body type : Raw  (JSON)
Body      :
{
  "firstName": "{{1.firstName}}",
  "lastName":  "{{1.lastName}}",
  "email":     "{{1.email}}",
  "phone":     "{{1.phone}}"
}

Make

Module HTTP → Make a request

Zapier

Action « Webhooks by Zapier → Custom Request »

n8n

Node « HTTP Request »

Endpoints disponibles

Accédez à toutes vos données via notre API REST

Contacts

5 endpoints

GET/api/crm/contactsLister les contacts

POST/api/crm/contactsCréer un contact

GET/api/crm/contacts/:idDétails d'un contact

PUT/api/crm/contacts/:idModifier un contact

DELETE/api/crm/contacts/:idSupprimer un contact

Projets

5 endpoints

GET/api/projectsLister les projets

POST/api/projectsCréer un projet

GET/api/projects/:idDétails d'un projet

PUT/api/projects/:idModifier un projet

DELETE/api/projects/:idSupprimer un projet

Devis

5 endpoints

GET/api/quotesLister les devis

POST/api/quotesCréer un devis

GET/api/quotes/:idDétails d'un devis

PUT/api/quotes/:idModifier un devis

GET/api/quotes/:id/pdfTélécharger le PDF

Factures

5 endpoints

GET/api/invoicesLister les factures

POST/api/invoicesCréer une facture

GET/api/invoices/:idDétails d'une facture

PUT/api/invoices/:idModifier une facture

GET/api/invoices/:id/pdfTélécharger le PDF

Formulaires

4 endpoints

GET/api/formsLister les formulaires

POST/api/formsCréer un formulaire

GET/api/forms/:idDétails d'un formulaire

POST/api/forms/:id/responsesSoumettre une réponse

Produits

4 endpoints

GET/api/productsLister les produits

POST/api/productsCréer un produit

PUT/api/products/:idModifier un produit

DELETE/api/products/:idSupprimer un produit

Exports CSV

5 endpoints

GET/api/crm/contacts/exportExporter tous les contacts (CSV)

GET/api/projects/exportExporter tous les projets (CSV)

GET/api/quotes/exportExporter tous les devis (CSV)

GET/api/invoices/exportExporter toutes les factures (CSV)

GET/api/products/exportExporter le catalogue (CSV)

Prêt à intégrer Ibda ?

Créez votre compte pour obtenir votre clé API et commencez à automatiser vos workflows

Créer un compte Contacter l'équipe