De Market Dojo API

De Market Dojo API

Wat is het probleem waar je tegenaan loopt?

Ik wil graag verbinding maken met de Market Dojo API. Hoe kan ik dat doen?

Oplossing

Market Dojo is programmatisch toegankelijk via de API.

Stappen

  1. Log in bij Market Dojo

  2. Ga naar je profielpagina en noteer je e-mailadres en Market Dojo API-sleutel.

  3. Ga naar https://secure.marketdojo.com/api/v1/documentation  

  4. Bekijk de beschikbare eindpunten om te begrijpen hoe de API werkt.

  5. Houd er rekening mee dat u rechtstreeks vanuit de documentatiepagina met de API kunt experimenteren.

Wat zijn de rapportage-API's?

Market Dojo biedt een aantal API-eindpunten die zijn ontworpen voor gebruik met rapportagetools zoals Power BI.

Naast de hieronder vermelde eindpunten is de documentatie voor de v1 API-eindpunten te vinden op https://gl.marketdojo.com/api/v1/documentation.

Gebruikmaken van de rapportage-API's

Verzoeken moeten worden ingediend bij:

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

- het door uw bedrijf geconfigureerde domein (bijv. https://acme.marketdojo.com of https://procurement.acme.com).


Verzoeken met een hostheader voor een ander domein worden geblokkeerd.


De rapportage-API's vereisen 2 standaardparameters:

e-mail : het e-mailadres van de gebruiker die toegang heeft tot het eindpunt

api_key : de API-sleutel van de gebruiker (deze is te vinden op hun profielpagina in de Market Dojo-applicatie)


Als je de eindpunten via de commandoregel gebruikt, kan het nodig zijn om de URL tussen aanhalingstekens te plaatsen.


bijv.

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


De resultaten worden in JSON-formaat geretourneerd.

Dingen om te controleren

  • Is de gebruiker lid van de (standaard)groep? Zo niet, dan krijgt hij/zij een 403-foutmelding.

Een API-sleutel verkrijgen

Een API-sleutel is vereist om de API te kunnen gebruiken.

Volg hier de instructies om uw API-sleutel te verkrijgen.

Als u de optie om uw API-sleutel aan te maken of te bekijken niet ziet, vraag dan uw superhost om de API in te schakelen op de pagina Admin > Integraties.


Beschikbare API-eindpunten voor rapportage

Bedrijven

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


Dit eindpunt geeft informatie over het bedrijf van de gebruiker terug.

Gebruikers

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


Dit eindpunt geeft informatie over alle gebruikers binnen het bedrijf.

Contracten

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



Dit eindpunt geeft details terug van de contracten die de gebruiker kan inzien.

Evenementen

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


Dit eindpunt geeft details terug van de gebeurtenissen die de gebruiker kan bekijken.

Vragenlijst

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


Dit eindpunt retourneert details van een vragenlijst, inclusief de ontvangen antwoorden.

LET OP: :id moet worden vervangen door het id (een nummer) van de vragenlijst.

SIM-deelnemers

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


Dit eindpunt retourneert details van de deelnemers aan een leveranciersonboardingevenement.


SRM

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


Dit eindpunt retourneert details van de SRM-suite van een gebruiker. Informatie zoals srm_accounts, srm_contacts, activiteiten en gebeurtenissen.