Référence PintAPI v2.

L'API REST de BPaaS pour intégrer vos déploiements à votre billetterie, votre CRM ou votre ERP. Authentification, endpoints et exemples.

Base : api.barpro.fr/v2 Auth Bearer · TLS

Introduction

PintAPI v2 est une API REST permettant d'intégrer BPaaS à votre système de billetterie, votre CRM événementiel ou votre ERP financier. Toutes les requêtes s'effectuent en HTTPS vers https://api.barpro.fr/v2 et renvoient du JSON. Les volumes sont exprimés en litres, les horodatages au format IS 8601 (UTC).

Authentification

L'authentification s'effectue par jeton porteur (Bearer) transmis dans l'en-tête Authorization. Les clés se génèrent depuis le dashboard, section Paramètres → API. Une clé est rattachée à une organisation et hérite de ses droits.

curl https://api.barpro.fr/v2/deployments \
  -H "Authorization: Bearer sk_live_pint_xxxxxxxxxxxx"

Sécurité. Ne diffusez jamais une clé sk_live côté client. Les flux entre tireuses et API sont chiffrés de bout en bout par HopsMesh Security™ (conformité ISO 27001).

Points d'entrée principaux

Méthode	Endpoint	Description
GET	/deployments	Liste les déploiements de l'organisation.
POST	/deployments	Crée un déploiement à partir d'une configuration.
GET	/deployments/{id}/flowlogs	Récupère les FlowLogs d'un déploiement.
POST	/deployments/{id}/rollback	Annule une commande (BarRollback™).
DELETE	/deployments/{id}	Clôture et libère un déploiement.

Exemple — récupérer les FlowLogs

GET /v2/deployments/{id}/flowlogs renvoie la liste horodatée des tirages mesurés.

{
  "deployment_id": "seminaire-altea-2026",
  "region": "paris",
  "flowlogs": [
    {
      "tap_id": "tap-03",
      "volume_l": 0.50,
      "beer": "ipa-houblonnee",
      "timestamp": "2026-05-14T19:42:07Z"
    },
    {
      "tap_id": "tap-01",
      "volume_l": 0.25,
      "beer": "blonde-maison",
      "timestamp": "2026-05-14T19:42:11Z"
    }
  ],
  "total_served_l": 0.75
}

Codes de réponse

Code	Signification
`200`	Requête traitée avec succès.
`201`	Ressource créée (déploiement).
`401`	Clé d'API manquante ou invalide.
`409`	Conflit — déploiement déjà actif sur cette région.
`429`	Limite de débit atteinte (1 000 req/min).

Limites de débit

L'API tolère 1 000 requêtes par minute et par organisation. Au-delà, les requêtes reçoivent un code 429 avec un en-tête Retry-After. Les webhooks FlowLogs constituent une alternative recommandée pour les flux à haute fréquence.