pm.builders · pour les DSI
Branchez vos systèmes sur chaque .pm.
Une API REST, une clé pour tous les .pm, des webhooks signés. Documentée en OpenAPI, limitée, tracée, hébergée en France. Vos données vont là où vous les envoyez, nulle part ailleurs.
L’API
Une clé, tous les .pm.
Une clé Bearer ouvre chaque espace, dans le périmètre exact du compte qui l’a créée : ses cartes, son équipe, son enseigne. Un espace de noms par application, une réponse JSON prévisible.
$ curl https://pm.builders/api/leads/get?since=2026-09-01T00:00:00Z \
-H "Authorization: Bearer pmk_…"
HTTP/1.1 200 OK
X-RateLimit-Remaining: 119
{"data": [{"id": "c9e3…", "consent": true, …}], "total": 1}
Webhooks
Des événements, pas du polling.
Un consentement recueilli ou retiré, un lead suivi, une carte créée : votre système est prévenu au moment où ça arrive. Chaque envoi nomme son événement ; un envoi refusé est rejoué jusqu’à être accepté.
consent.addConsentement recueilliconsent.removeConsentement retirélead.updateSuivi commercial modifiélead.actionAction sur un contactcard.addCarte crééecard.updateCarte modifiéecard.removeCarte mise à la corbeille
X-PM-Event- Le nom de l’événement, sur chaque envoi.
X-Consent-Signature- t=<horodatage>,v1=<HMAC-SHA-256> du corps exact, avec votre secret whsec_ : vous vérifiez l’origine et refusez les rejeux.
apikey · Authorization- Votre clé de réception, dans l’en-tête que votre passerelle attend.
Sécurité
Sûr par défaut, vérifiable par vous.
- 01
Des clés qu’on ne peut pas relire
Le secret s’affiche une seule fois ; nous n’en gardons que l’empreinte SHA-256. Lecture seule au choix, révocation immédiate, 10 clés actives par compte.
- 02
Le périmètre du compte, rien de plus
Une clé voit ce que voit son compte. Une donnée hors de son périmètre n’existe pas pour elle : réponse 404, jamais une fuite.
- 03
Des limites annoncées
120 lectures et 30 écritures par minute et par clé, 60 requêtes par minute et par IP ; une IP qui échoue dix fois en cinq minutes est bloquée. Chaque réponse donne son reste.
- 04
Des preuves scellées
Chaque consentement et chaque retrait est signé (HMAC-SHA-256) et conservé comme preuve ; l’API vous rend l’état courant, retraits compris.
Contrat
Un contrat stable, écrit une fois.
OpenAPI 3
Chaque route décrite une seule fois : la documentation et openapi.json sortent de la même source.
Des erreurs qui se testent
Toujours {"error": {"code", "message"}} : vous branchez votre logique sur un code stable, jamais sur un texte.
Idempotence
Un en-tête Idempotency-Key rend un dépôt de consentement rejouable sans doublon.
Des corps stricts
JSON seulement, 64 Ko au plus, champs inconnus refusés : ce que vous envoyez est ce qui est enregistré.
Vos données vont là où vous les envoyez. Nulle part ailleurs.
Prêt à brancher votre SI ?
L’API et les webhooks s’ouvrent avec consent.pm pour toute l’enseigne. Parlons de votre architecture.

