Market Dojo API

Market Dojo API

Vilket problem står du inför?

Jag vill ansluta till Market Dojo API. Hur kan jag göra det?

Lösning

Market Dojo kan nås programmatiskt med hjälp av API:et.

Steg

  1. Logga in på Market Dojo

  2. Gå till din profilsida, anteckna din e-postadress och Market Dojo API-nyckel

  3. Gå till https://secure.marketdojo.com/api/v1/documentation  

  4. Granska tillgängliga slutpunkter för att förstå hur API:et fungerar

  5. Observera att du kan experimentera med API:et direkt från dokumentationssidan

Vilka är rapporterings-API:erna

Market Dojo tillhandahåller ett antal API-slutpunkter utformade för användning med rapporteringsverktyg som Power BI.

Utöver slutpunkterna som listas nedan finns dokumentation för v1 API-slutpunkter på https://gl.marketdojo.com/api/v1/documentation

Använda rapporterings-API:erna

Begäran måste göras till antingen:

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

- ditt företags konfigurerade domän (t.ex. https://acme.marketdojo.com eller https://procurement.acme.com).


Förfrågningar med en värdheader för någon annan domän blockeras.


Rapporterings-API:erna använder två standardparametrar:

e-postadress : e-postadressen för användaren som använder slutpunkten

api_key : användarens API-nyckel (denna finns på deras profilsida i Market Dojo-applikationen)


Om du använder slutpunkterna från kommandoraden kan det vara nödvändigt att omge URL:en med citattecken.


till exempel

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


Resultaten returneras i JSON-format.

Saker att kontrollera

  • Är användaren medlem i (standard)gruppen? Om inte, får de ett 403-felmeddelande.

Att få en API-nyckel

En API-nyckel krävs för att använda API:et.

Följ instruktionerna här för att få din API-nyckel.

Om du inte ser alternativet att skapa eller visa din API-nyckel, be din superhost att aktivera API:et på sidan Admin>Integrationer.


Tillgängliga slutpunkter för rapporterings-API:et

Företag

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


Denna slutpunkt returnerar information om användarens företag.

Användare

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


Denna slutpunkt returnerar information om alla användare i företaget.

Kontrakt

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



Denna slutpunkt returnerar information om de kontrakt som användaren har åtkomst till att se.

Händelser

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


Denna slutpunkt returnerar information om de händelser som användaren har åtkomst att visa.

Frågeformulär

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


Denna slutpunkt returnerar information om ett frågeformulär, inklusive de svar som har mottagits.

OBS: :id ska ersättas med frågeformulärets id (ett nummer).

SIM-deltagare

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


Denna slutpunkt returnerar information om deltagarna i ett onboarding-evenemang för leverantörer.


SRM

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


Denna slutpunkt returnerar detaljer om en användares SRM-svit. Information som srm_accounts, srm_contacts aktiviteter och händelser.