Aller au contenu principal

S'authentifier à l'API

L'adresse de base de l'API est https://gateway.erpconnector.ca/api. Toute requête doit être en HTTPS et authentifiée.

La méthode : Basic Auth (depuis la version 4)​

  • Nom d'utilisateur = votre Code Licence (clé unique de votre instance).
  • Mot de passe = votre Clé API secrète.
  • Concrètement : header Authorization: Basic base64(CodeLicence:CléSecrète).

Le HUB valide la paire auprès du gestionnaire de licences : une licence inexistante, expirée ou pas encore démarrée est refusée (réponse 401).

Choisir la compagnie : header COMPANY_ID​

Si votre licence donne accès à plusieurs compagnies, ajoutez le header COMPANY_ID avec l'identifiant de la compagnie visée. Sans ce header, la compagnie par défaut (0) est utilisée. L'identifiant est visible sur le site de gestion des compagnies de votre code licence.

Exemple complet​

GET https://gateway.erpconnector.ca/api/Entity/Customer?$top=5
Authorization: Basic {base64(CodeLicence:CléSecrète)}
COMPANY_ID: 0

Notes​

  • La clé secrète se définit dans le portail web de gestion des licences (nouvelles instances ERPConnector) ; sur les anciennes instances OnlineERP, dans le menu OPTIONS du robot (« Cette clé secrète, combinée au code de licence, constitue l'intégralité de votre clé d'API »).
  • Ne partagez jamais la clé secrète ; elle se transmet à l'intégrateur au moment de l'installation (voir Prérequis et obtention des accès).
  • 401 = code licence ou clé invalide/expirée. Vérifiez aussi que vous appelez bien https://gateway.erpconnector.ca/api et non une ancienne adresse (*.onlineerp.solution.quebec, obsolète).