Authentification et clés
Chaque appel présente une clé d’API dans l’en-tête Authorization. L’API est servie uniquement en HTTPS.
Dans cette documentation, les exemples utilisent votre clé de test quand vous êtes connecté : copiez-les tels quels pour essayer, puis remplacez-la par votre clé sg_live_… pour publier.
Deux sortes de clés
| Clé | Disponible | Effet |
|---|---|---|
| sg_test_… | Tout de suite | Tous les contrôles, aucune publication : idéal pour brancher et tester votre logiciel |
| sg_live_… | Agence validée | Publication sur sitigeo.com |
Créer, garder, révoquer
Les clés se créent dans Mon espace API (2 clés de test et 2 clés de production actives au plus, 10 créations par jour). Vous pouvez réafficher une clé à tout moment depuis votre espace, en retapant le mot de passe de votre compte : elle est conservée chiffrée, et l’API ne compare que son empreinte. Rangez-la dans la configuration de votre logiciel, jamais dans une page web ou une application mobile.
Une clé qui a fuité se révoque en un clic ; les appels qui l’utilisent échouent aussitôt (401 cle_invalide). Créez-en une nouvelle avant de révoquer l’ancienne pour ne rien interrompre.
Validation de l’agence
Le SIREN est vérifié automatiquement au registre public des entreprises : une société active du secteur immobilier est validée tout de suite. Une autre activité passe par une vérification de l’équipe Sitigeo ; une société fermée est refusée. La carte professionnelle (carte T) est contrôlée sur son format et engage la personne qui la déclare.