L'API Market Dojo

L'API Market Dojo

Quel est le problème que vous rencontrez ?

Je souhaite me connecter à l'API Market Dojo. Comment puis-je procéder ?

Solution

Market Dojo est accessible par programmation via l'API.

Mesures

  1. Se connecter à Market Dojo

  2. Rendez-vous sur votre page de profil et notez votre adresse e-mail et votre clé API Market Dojo.

  3. Consultez la documentation : https://secure.marketdojo.com/api/v1/documentation  

  4. Consultez les points de terminaison disponibles pour comprendre le fonctionnement de l'API.

  5. Notez que vous pouvez expérimenter avec l'API directement depuis la page de documentation.

Quelles sont les API de reporting ?

Market Dojo propose plusieurs points de terminaison API conçus pour être utilisés avec des outils de reporting tels que Power BI.

Outre les points de terminaison listés ci-dessous, la documentation relative aux points de terminaison de l'API v1 est disponible à l' adresse https://gl.marketdojo.com/api/v1/documentation

Utilisation des API de reporting

Les demandes doivent être adressées soit à :

- https://secure.marketdojo.com, ou

- le domaine configuré de votre entreprise (par exemple, https://acme.marketdojo.com ou https://procurement.acme.com).


Les requêtes comportant un en-tête d'hôte pour un autre domaine sont bloquées.


Les API de reporting prennent 2 paramètres standard :

email : l'adresse email de l'utilisateur qui accède au point de terminaison

api_key : la clé API de l'utilisateur (celle-ci se trouve sur sa page de profil dans l'application Market Dojo).


Si vous utilisez les points de terminaison depuis la ligne de commande, il peut être nécessaire d'encadrer l'URL de guillemets.


par exemple

curl ' https://secure.marketdojo.com/api/v2/reports/contracts?email=email&api_key=api_key '


Les résultats sont renvoyés au format JSON.

Éléments à vérifier

  • L'utilisateur est-il membre du groupe (par défaut) ? Si ce n'est pas le cas, il recevra une erreur 403.

Obtention d'une clé API

Une clé API est requise pour utiliser l'API.

Suivez les instructions ici pour obtenir votre clé API.

Si vous ne voyez pas l'option permettant de créer ou de consulter votre clé API, veuillez demander à votre superhôte d'activer l'API sur la page Admin > Intégrations.


Points de terminaison d'API de reporting disponibles

Entreprises

https://secure.marketdojo.com/api/v2/reports/companies?email=email&api_key=key


Ce point de terminaison renverra des informations sur l'entreprise de l'utilisateur.

Utilisateurs

https://secure.marketdojo.com/api/v2/reports/users?email=email&api_key=key


Ce point de terminaison renverra des informations sur tous les utilisateurs de l'entreprise.

Contrats

https://secure.marketdojo.com/api/v2/reports/contracts?email=email&api_key=key



Ce point de terminaison renverra les détails des contrats que l'utilisateur a accès à consulter.

Événements

https://secure.marketdojo.com/api/v2/reports/events?email=email&api_key=key


Ce point de terminaison renverra les détails des événements que l'utilisateur a accès à consulter.

Questionnaire

https://secure.marketdojo.com/api/v2/reports/questionnaires/:id?email=email&api_key=key


Ce point de terminaison renverra les détails d'un questionnaire, y compris les réponses reçues.

REMARQUE : :id doit être remplacé par l'identifiant (un nombre) du questionnaire.

Participants SIM

https://secure.marketdojo.com/api/v2/reports/sim_participants?email=email&api_key=key


Ce point de terminaison renverra les détails des participants à un événement d'intégration des fournisseurs.


SRM

https://secure.marketdojo.com/api/v2/reports/srm?email=email&api_key=key


Ce point de terminaison renverra les détails de la suite SRM d'un utilisateur, notamment les informations relatives aux comptes SRM, aux contacts SRM, aux activités et aux événements.