Ce guide explique étape par étape comment demander des identifiants d’accès API aux transporteurs maritimes (Maersk, CMA CGM, COSCO, Hapag-Lloyd, etc.) et à des systèmes externes similaires, puis comment les enregistrer dans heyAtlas.
1. Quand en avez-vous besoin ?
Les outils heyAtlas comme la recherche de tarifs, le suivi de conteneur/navire, la récupération de tarifs et le booking se connectent à l’API du transporteur pour le compte de votre entreprise. Cette connexion nécessite les identifiants API que le transporteur vous attribue spécifiquement. Sans identifiants, les outils concernés ne peuvent pas fonctionner, et l’assistant vous demandera les informations de connexion.
- Votre premier contact est le chargé de compte ou le représentant commercial de votre entreprise auprès du transporteur.
- Chez la plupart des grands transporteurs, la demande est transférée à l’équipe intégration/IT via votre représentant.
- Indiquez dans votre demande : le cas d’usage (ex. requête de tarif, suivi de conteneur), l’environnement demandé (test/production) et votre code client.
Modèle d’e-mail de demande à copier-coller
Objet : Demande d’accès API / intégration — [Nom de l’entreprise], client n° : [XXXX]
Bonjour,
Chez [Nom de l’entreprise], nous gérons nos opérations via notre assistant digital. Pourriez-vous partager les identifiants d’accès API qui nous sont attribués (nom d’utilisateur / clé API, URLs d’endpoint, et code client le cas échéant) ? Notre cas d’usage : [recherche de tarifs / suivi de conteneur / booking]. Nous souhaitons d’abord recevoir les informations de l’environnement de test, puis les identifiants de production après validation.
Merci de transmettre les mots de passe et les clés via un canal sécurisé plutôt que dans le corps de l’e-mail.
Merci.
| Élément | Notes |
|---|
| Nom d’utilisateur API / Client ID | Identifiant de connexion |
| Mot de passe / clé API / Client Secret | Valeur secrète — doit être partagée via un canal sécurisé |
| URL d’endpoint | Les adresses de test et de production peuvent différer |
| Code client | Obligatoire chez certains transporteurs |
| Environnement | Test (sandbox) ou production |
| Restriction IP | Si le transporteur impose une allowlist IP, les IP de heyAtlas doivent être ajoutées |
4. Conseils spécifiques aux transporteurs
- Transporteurs disposant d’un portail développeur en libre-service (ex. Maersk, CMA CGM, Hapag-Lloyd) : vous pouvez vous inscrire sur le portail développeur du transporteur au nom de votre entreprise, créer une application et générer votre propre clé. L’approbation peut prendre quelques jours ouvrés.
- Transporteurs avec un processus manuel : un formulaire est rempli via votre représentant ; l’équipe d’intégration fournit les clés.
- Vous n’avez pas besoin de savoir quel type d’authentification (API Key, OAuth2, etc.) chaque transporteur utilise ; la définition système heyAtlas applique automatiquement la bonne méthode. Votre rôle consiste simplement à saisir intégralement les informations fournies par le transporteur.
- Ouvrez Paramètres → Identifiants dans le portail (autorisation administrateur de l’entreprise requise).
- Sélectionnez le système concerné (transporteur) et remplissez les champs fournis par le transporteur.
- Vous pouvez définir plusieurs identifiants pour le même système et en marquer un comme par défaut (ex. différents codes clients).
- Après l’enregistrement, vérifiez la connexion en testant l’outil concerné via l’assistant.
Voir aussi : Gérer les identifiants et Connexions système.
6. Sécurité
- Évitez de recevoir des mots de passe et des clés en texte brut dans le corps d’un e-mail ; privilégiez un lien de partage sécurisé.
- heyAtlas stocke les identifiants de manière chiffrée et ne les affiche jamais en texte brut à l’écran.
- Si vous suspectez une fuite, demandez au transporteur de faire une rotation de la clé et mettez à jour la nouvelle valeur dans heyAtlas.
- Voir aussi : Sécurité des identifiants.
7. Problèmes fréquents
- Erreurs 401 / 403 : le mot de passe peut être mal saisi, expiré, ou le compte pas encore activé. Ressaisissez les informations ; si le problème persiste, demandez à votre représentant de les vérifier.
- Confusion test / production : une clé de test ne fonctionnera pas avec l’endpoint de production (ou inversement). Vérifiez les informations de l’environnement qui ont été saisies.
- « Accès accordé » mais rien ne fonctionne : certains transporteurs activent les abonnements API par produit (ex. suivi uniquement) ; demandez quels produits votre abonnement couvre.
- Blocage IP : si le transporteur applique des restrictions IP, l’IP depuis laquelle heyAtlas appelle doit être ajoutée à l’allowlist ; vous pouvez demander les détails IP à notre équipe support.
8. Obtenir de l’aide
Si le processus est bloqué, ouvrez un ticket support via Support → Mes tickets ; indiquez simplement de quel transporteur il s’agit et à quelle étape vous êtes bloqué.
