Ublo API Cookbook
Guide pratique pour intégrer l’API GraphQL Ublo en tant qu’intégrateur tiers (Bearer token). Ce cookbook complète la documentation développeurs officielle : il ne remplace ni le schéma GraphQL, ni les pages de domaines.
Ce que vous y trouverez
- Démarrage — authentification API token, client HTTP minimal, conventions (montants, IDs, erreurs).
- Workflows step-by-step — enchaînements métier réels, avec code en onglets GraphQL / Node.js / curl.
- Recettes — listes paginées (lots, dossiers) et lecture d’un dossier, prêtes à coller.
Légende des sources
| Badge | Signification |
|---|---|
| Observé | Reconstruit depuis une capture d’appels GraphQL de l’UI admin (requêtes/variables anonymisées). |
| Reconstruit | Croisement doc utilisateur métier + schéma / cas d’usage officiels (pas de capture UI pour ce parcours). |
Parcours recommandé
- Authentification
- Vue d’ensemble des workflows
- Chaîne observée : compte bancaire → organisation → lot → comptabilité → complétion
- Chaîne reconstruite : propriétaire → locataire → dossier
- Chaîne observée (dossier) : activer → contrat → facturer → encaisser
Périmètre volontaire
- Exemples statiques (pas d’exécution live dans ce site).
- Public intégrateurs tiers (pas le cookie de session admin).
- Les montants monétaires capturés sont exprimés en centimes d’euro (voir Argent & identifiants).