Clés et authentification
Chaque requête porte une clé privée dans l’en-tête Authorization. Les clés se gèrent depuis la console développeur de votre compte Atlas.
Envoyer la clé
Authorization: Bearer atlas_maps_<64 caractères hexadécimaux> User-Agent: MonApp/1.0
Une clé absente, mal formée, expirée ou révoquée donne 401 unauthorized. Les clients qui envoient un identifiant automatique par défaut (par exemple Python-urllib) peuvent être refusés par l’hébergement avant même l’API : indiquez toujours votre propre User-Agent.
Ce qu’Atlas conserve
Affichée une seule fois
La clé complète n’est montrée qu’à sa création ou à son renouvellement. Atlas ne peut pas la réafficher : en cas de perte, créez-en une autre.
Stockée sous forme d’empreinte
Seule une empreinte SHA-256 de la clé est enregistrée, avec ses 20 premiers caractères pour que vous la reconnaissiez dans la console.
Durée de vie limitée
Une clé expire 90 jours après sa création. 5 clés actives au plus par compte.
Portées
Choisie à la création, la portée limite ce que la clé peut appeler.
| Portée | Points d’accès autorisés |
|---|---|
| Lieux et itinéraires | places, reverse, directions |
| Lieux uniquement | places, reverse |
| Itinéraires uniquement | directions |
Un appel hors portée donne 403 insufficient_scope. Les étiquettes Test et Production et les projets servent à organiser vos clés ; elles donnent accès aux mêmes données et partagent le même quota.
Renouveler sans interruption
Le renouvellement crée une nouvelle clé ; l’ancienne reste valable 24 heures, le temps de déployer la nouvelle. Une seule transition à la fois par compte. En cas de fuite, révoquez la clé : l’effet est immédiat.