Connecter ShippingEasy : vérifier vos identifiants API

Copiez votre clé API et votre secret API depuis la même page API Credentials de ShippingEasy, collez-les dans Integration et lancez le test signé : cette connexion ne vérifie que les identifiants.

Le connecteur ShippingEasy vérifie vos identifiants API ShippingEasy dans Integration. Vous saisissez une clé API et un secret API ; chaque requête est signée avec le secret en HMAC-SHA256, et le secret lui-même n’est jamais envoyé en clair. Cette connexion sert uniquement à vérifier les identifiants : avec la Customer API de ShippingEasy, elle ne propose ni comparaison de tarifs, ni achat d’étiquettes, ni recherche de suivi par numéro.

Prérequis#

• Un compte ShippingEasy, avec accès à Settings → API Credentials.
• Ayez votre clé API et votre secret API sous la main — les deux se trouvent sur la même page : Settings → API Credentials (app.shippingeasy.com/settings/api_credentials).
• Sachez à quoi sert cette connexion avant de commencer : elle ne vérifie que les identifiants. Elle n’ajoute à Integration ni comparaison de tarifs, ni achat d’étiquettes, ni recherche de suivi.

Obtenir les identifiants#

1. Connectez-vous à ShippingEasy et allez dans Settings → API Credentials (app.shippingeasy.com/settings/api_credentials).
2. Sur cette page, copiez la clé API. C’est la clé API publique de ce compte.
3. Sur la même page, copiez le secret API. C’est le secret API privé : chaque requête est signée avec lui en HMAC-SHA256, et le secret lui-même n’est jamais envoyé en clair.
4. Conservez la clé et le secret ensemble, comme une paire prise sur cette seule page, et gardez le secret en lieu sûr.

Remplir dans Integration#

1. Ouvrez Integration → Marketplace → ShippingEasy → Nouvelle connexion.
2. Clé API (api_key), obligatoire : collez la clé API de ShippingEasy → Settings → API Credentials. Ne mettez la clé que dans le champ Key — ne l’inversez pas avec le secret.
3. Secret API (api_secret), obligatoire : collez le secret API de la même page Settings → API Credentials. Il est chiffré au repos, jamais réaffiché ; Integration l’utilise pour signer chaque requête en HMAC-SHA256, et le secret lui-même n’est pas envoyé en clair.

Tester la connexion#

Cliquez sur Tester la connexion. Le test signe une requête en lecture seule avec votre secret API et liste les commandes avec GET https://app.shippingeasy.com/api/orders?per_page=1 — 1 seule commande comme sonde. Réussi, cela signifie que les identifiants signés fonctionnent et peuvent lister les commandes. Cela ne prouve rien d’autre : il ne vérifie pas les tarifs, n’achète pas d’étiquette et ne recherche pas de suivi, car cette connexion ne propose pas ces fonctions.

Mapping / choisir un modèle#

Pour cette connexion, il n’y a ni mapping ni modèle à choisir. Elle n’importe pas de commandes vers un autre système et ne mappe pas de services d’expédition : avec la Customer API de ShippingEasy, la comparaison de tarifs, l’achat d’étiquettes et la recherche de suivi par numéro ne sont pas pris en charge via cette connexion, il n’y a donc rien à mapper pour eux. Si vous avez besoin de tarifs ou d’étiquettes, faites ce travail dans ShippingEasy même.

Activer#

Après activation, la connexion est enregistrée comme vérifiée et prête pour les contrôles d’identifiants. Rien d’autre ne se met à fonctionner via elle : la comparaison de tarifs, l’achat d’étiquettes et la recherche de suivi ne font pas partie de cette connexion, continuez donc à les faire dans ShippingEasy même. Si vous remplacez la clé API ou le secret API dans ShippingEasy, mettez à jour les deux valeurs ici et testez à nouveau.

FAQ#

Le test échoue avec 401

La clé API ou le secret API est incorrect, ou les deux ont été inversés, donc la signature HMAC-SHA256 ne correspond pas et ShippingEasy rejette la sonde signée.

Retournez dans ShippingEasy → Settings → API Credentials (app.shippingeasy.com/settings/api_credentials), copiez la clé API dans le champ API Key et le secret API dans le champ API Secret tels qu’ils apparaissent sur cette même page, puis testez à nouveau.

Le test indique des identifiants manquants

Un champ ou les deux sont vides. Le test ne peut pas signer de requête sans la clé API et le secret API à la fois, il s’arrête donc avant la sonde.

Remplissez les deux champs depuis la même page Settings → API Credentials, enregistrez, puis testez à nouveau. N’en remplir qu’un seul ne suffit pas.

Le test réussit, mais je ne peux ni comparer les tarifs, ni acheter une étiquette, ni consulter le suivi

C’est la portée de cette connexion, pas un échec : elle ne vérifie que les identifiants. Un test réussi prouve seulement que les identifiants signés peuvent lister les commandes — la Customer API de ShippingEasy ne donne à cette connexion ni endpoint de tarifs, ni endpoint d’achat d’étiquettes, ni endpoint de suivi par numéro.

Utilisez cette connexion uniquement pour les contrôles d’identifiants, et continuez à faire tarifs, étiquettes et le reste du travail d’expédition dans ShippingEasy même. N’attendez pas qu’un test réussi active ces fonctions dans Integration.