API-ul Market Dojo

API-ul Market Dojo

Care este problema cu care te confrunți?

Aș dori să mă conectez la API-ul Market Dojo. Cum pot face asta?

Soluţie

Market Dojo poate fi accesat programatic folosind API-ul.

Pași

  1. Conectați-vă la Market Dojo

  2. Accesați pagina dvs. de profil, notați adresa dvs. de e-mail și cheia API Market Dojo.

  3. Accesați https://secure.marketdojo.com/api/v1/documentation  

  4. Examinați endpoint-urile disponibile pentru a înțelege cum funcționează API-ul

  5. Rețineți că puteți experimenta cu API-ul direct de pe pagina de documentație.

Care sunt API-urile de raportare

Market Dojo oferă o serie de endpoint-uri API concepute pentru utilizare cu instrumente de raportare precum Power BI.

Pe lângă endpoint-urile enumerate mai jos, documentația endpoint-urilor API v1 poate fi găsită la https://gl.marketdojo.com/api/v1/documentation

Utilizarea API-urilor de raportare

Cererile trebuie adresate fie către:

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

- domeniul configurat al companiei dvs. (de exemplu, https://acme.marketdojo.com sau https://procurement.acme.com).


Cererile cu un antet gazdă pentru orice alt domeniu sunt blocate.


API-urile de raportare acceptă 2 parametri standard:

e-mail : adresa de e-mail a utilizatorului care accesează endpoint-ul

api_key : cheia API a utilizatorului (aceasta poate fi găsită pe pagina de profil a acestuia în aplicația Market Dojo)


Dacă utilizați punctele finale din linia de comandă, poate fi necesar să includeți adresa URL între ghilimele.


de exemplu

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


Rezultatele sunt returnate în format JSON.

Lucruri de verificat

  • Utilizatorul este membru al grupului (implicit)? Dacă nu, va primi o eroare 403.

Obținerea unei chei API

O cheie API este necesară pentru a utiliza API-ul.

Urmați instrucțiunile de aici pentru a obține cheia API.

Dacă nu vedeți opțiunea de a crea sau vizualiza cheia API, vă rugăm să solicitați supergazdei dvs. să activeze API-ul pe pagina Administrator>Integrări.


Puncte finale API de raportare disponibile

Companii

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


Acest endpoint va returna informații despre compania utilizatorului.

Utilizatori

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


Acest endpoint va returna informații despre toți utilizatorii din companie.

Contracte

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



Acest endpoint va returna detalii despre contractele pe care utilizatorul are acces să le vizualizeze.

Evenimente

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


Acest punct final va returna detalii despre evenimentele pe care utilizatorul are acces să le vizualizeze.

Chestionar

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


Acest endpoint va returna detalii despre un chestionar, inclusiv răspunsurile primite.

NOTĂ: :id trebuie înlocuit cu id-ul (un număr) al chestionarului.

Participanți la SIM

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


Acest endpoint va returna detalii despre participanții la un eveniment de integrare a furnizorilor.


SRM

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


Acest endpoint va returna detalii despre suita SRM a unui utilizator. Informații precum activitățile și evenimentele srm_accounts, srm_contacts.