Introduction

Bloonio Relay est la couche d’intégration partagée de la plateforme Bloonio. Elle expose deux produits « relais », génériques et indépendants de tout locataire :

Auth Relay — authentification forte déléguée (appairage d’appareils, push d’approbation, connexion par QR, élévation « sudo », passkeys).
Chat Relay — chat multi-tenant et tickets (widget web, SDK in-app, opérateurs humains, callbacks webhook, console libre-service).

Les deux relais sont conçus pour être branchés sur n’importe quel backend, à la manière d’un fournisseur d’identité tiers : votre application devient un tenant du relais, et tout passe par un contrat d’intégration unique.

Pourquoi un hub commun

Auth Relay et Chat Relay partagent délibérément la même architecture :

une collection tenants commune et un même cycle de vie de provisioning ;
un même schéma de signature HMAC (mêmes en-têtes, même calcul) pour tous les appels backend → relais ;
le même validateur universel, relay_user_id (modèle « Stripe Connect »), qui relie un utilisateur à plusieurs tenants sans fuite entre locataires ;
des SDK au même format (Python aujourd’hui, variantes à venir).

Apprenez le modèle une fois sur les pages Concepts de la plateforme, puis appliquez-le des deux côtés.

Multi-tenant & relay_user_id Le modèle de locataires et le validateur universel.

Authentification (HMAC) La recette de signature, commune aux deux relais.

Cycle de vie d'un tenant Provisionner, faire tourner les secrets, suspendre.

Webhooks & callbacks Recevoir des événements signés sur votre backend.

Par où commencer

Vous intégrez l’authentification ? Commencez par Démarrage rapide — Auth Relay.
Vous intégrez le chat ? Commencez par Démarrage rapide — Chat Relay.
Vous découvrez la plateforme ? Lisez d’abord Multi-tenant & relay_user_id.

Conventions de cette documentation

Les exemples de requêtes utilisent un $BASE_URL à remplacer par l’URL de base du relais concerné. Nous ne codons jamais en dur d’hôte de passerelle interne.
Les secrets sont toujours des placeholders (tnt_..., sk_...) — à ne jamais committer.
La Référence API de chaque relais est générée à partir de sa spécification OpenAPI ; c’est la source faisant autorité pour les schémas exacts.