Documentation publique API

Connecter une plateforme externe à GLASSPHÈRE.

Cette page explique comment une société partenaire peut connecter son logiciel à GLASSPHÈRE, vérifier un garage grâce à son code de référence, contrôler ses jetons disponibles et créer une mission vitrage sans sortir du parcours métier de la plateforme partenaire.

Demander une clé API

Pour qui ?

Pour les sociétés qui gèrent déjà des garages ou des dossiers vitrage et qui souhaitent envoyer des missions directement vers GLASSPHÈRE.

Accès sécurisé

Chaque société partenaire reçoit une clé API privée, générée par le CEO depuis l'espace GLASSPHÈRE. La clé peut être modifiée, expirée ou supprimée.

Contrôle garage

Chaque garage demande son code de référence depuis son profil. Ce code sert à relier le garage GLASSPHÈRE avec son compte sur la plateforme partenaire.

Partenaires connectés

Sociétés déjà configurées dans GLASSPHÈRE

BRIGLASS GESTION

Partenaire API actif

Parcours recommandé

Comment connecter une société partenaire

La société contacte GLASSPHÈRE

Le partenaire contacte l'équipe GLASSPHÈRE pour expliquer son besoin, son logiciel et le volume de garages à connecter.

Le CEO crée la fiche partenaire

Depuis l'espace CEO, GLASSPHÈRE crée le partenaire API, ajoute son nom, son logo et génère une clé API privée. Cette clé ne doit jamais être exposée côté navigateur.

Le garage demande son code de référence

Dans son profil garage GLASSPHÈRE, le garage demande un code pour connecter GLASSPHÈRE avec une plateforme externe, par exemple BRIGLASS GESTION.

Le CEO valide la demande du garage

Après validation, GLASSPHÈRE génère un code unique pour ce garage. Le partenaire l'utilise une seule fois pour relier le compte garage des deux plateformes.

La plateforme partenaire crée les missions

À chaque création de mission, l'API vérifie le code du garage et son solde de jetons. Si le garage n'a plus de jetons, GLASSPHÈRE renvoie une réponse claire et refuse la création.

Base URL

Adresse de production

https://glassphere.fr/api/glassphere

Toutes les requêtes doivent être envoyées en HTTPS avec l'en-tête Accept: application/json. La clé partenaire doit être envoyée uniquement côté serveur, jamais dans le JavaScript public.

Authentification partenaire

Clé API de société

Chaque société reçoit une clé du type gsp_live_xxx. Elle doit être ajoutée dans les en-têtes de chaque appel API.

X-GLASSPHERE-KEY: gsp_live_votre_cle_api
Accept: application/json
Content-Type: application/json

Endpoints

Vérifier un garage et créer une mission

POST /garage/verify

Vérifier le code de référence garage

Cet endpoint sert à connecter une première fois le garage GLASSPHÈRE avec son compte sur la plateforme partenaire. Le partenaire stocke ensuite le code de référence dans sa base de données.

{
  "reference_code": "GLS-ABCD-EFGH",
  "platform": "BRIGLASS GESTION",
  "external_garage_id": "GARAGE-42"
}

{
  "ok": true,
  "code": "GARAGE_CONNECTED",
  "garage": {
    "id": 14,
    "name": "Garage Exemple",
    "city": "Paris",
    "tokens_balance": 3,
    "can_create_mission": true
  },
  "partner": {
    "name": "BRIGLASS GESTION"
  }
}

POST /missions

Créer une mission vitrage

La plateforme partenaire envoie les informations du dossier. GLASSPHÈRE vérifie le garage, consomme un jeton et retourne le lien exact vers la mission créée.

{
  "reference_code": "GLS-ABCD-EFGH",
  "external_mission_id": "DOSSIER-2026-001",
  "title": "Remplacement pare-brise Peugeot 308",
  "description": "Client disponible en matinée",
  "vehicle_brand": "Peugeot",
  "vehicle_model": "308",
  "registration_plate": "AA-123-AA",
  "vin": "VF3XXXXXXXXXXXXXX",
  "glass_type": "Pare-brise",
  "client_name": "Client masqué",
  "client_phone": "0600000000",
  "client_address": "12 rue Exemple",
  "client_city": "Paris",
  "client_postal_code": "75008",
  "desired_date": "2026-06-15",
  "desired_date_end": "2026-06-18",
  "desired_time": "09:00",
  "desired_time_end": "12:00",
  "proposed_price": 120
}

{
  "ok": true,
  "code": "MISSION_CREATED",
  "message": "Mission créée dans GLASSPHÈRE.",
  "mission": {
    "id": 125,
    "url": "https://glassphere.fr/missions/125",
    "status": "published"
  },
  "tokens_balance": 2
}

Réponse si le garage n'a plus de jetons

{
  "ok": false,
  "code": "NO_MISSION_TOKENS",
  "message": "Vous n'avez pas de jetons disponibles pour créer une mission dans GLASSPHÈRE.",
  "tokens_balance": 0
}

Exemple d'intégration

Cas BRIGLASS GESTION

Dans le détail d'un dossier BRIGLASS GESTION, afficher d'abord un bouton Connecter ce garage à GLASSPHÈRE. Une fois le code vérifié par l'API, le code est stocké dans la table garage ou dossier de BRIGLASS GESTION et le bouton devient Ajouter la mission sur GLASSPHÈRE.

Après création de la mission, stocker le champ mission.url dans la base BRIGLASS GESTION. Le bouton final devient Voir la mission sur GLASSPHÈRE et redirige directement vers ce lien.

Contact API

Demander un accès partenaire

Pour obtenir une clé API partenaire, contactez GLASSPHÈRE avec le nom de la société, le logiciel à connecter, l'usage prévu, les coordonnées du responsable technique et les exemples de dossiers à envoyer.

Email : contact@glassphere.fr