AtlasDéveloppeurs
Démarrer

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é

En-têtes
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éePoints d’accès autorisés
Lieux et itinérairesplaces, reverse, directions
Lieux uniquementplaces, reverse
Itinéraires uniquementdirections

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.