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.
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 son solde en euros et créer une mission vitrage sans sortir du parcours métier de la plateforme partenaire.
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 en euros. Si le solde est inférieur au coût TTC d'une mission, 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",
"credit_balance": 192,
"mission_cost_ttc": 48,
"default_technician_service_price_ht": 150,
"currency": "EUR",
"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, débite le coût TTC d'une mission de son solde 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"
},
"credit_balance": 144,
"mission_cost_ttc": 48,
"currency": "EUR",
"can_create_mission": true
}Réponse si le solde du garage est insuffisant
{
"ok": false,
"code": "INSUFFICIENT_CREDIT_BALANCE",
"message": "Votre solde GLASSPHÈRE est insuffisant pour publier cette mission.",
"credit_balance": 47,
"mission_cost_ttc": 48,
"currency": "EUR",
"can_create_mission": false
}
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
Email : contact@glassphere.fr