Die Market Dojo API

Die Market Dojo API

Welches Problem besteht bei Ihnen?

Ich möchte eine Verbindung zur Market Dojo API herstellen. Wie kann ich das tun?

Lösung

Market Dojo kann programmatisch über die API aufgerufen werden.

Schritte

  1. Bei Market Dojo anmelden

  2. Gehen Sie zu Ihrer Profilseite und notieren Sie sich Ihre E-Mail-Adresse und Ihren Market Dojo API-Schlüssel.

  3. Gehen Sie zu https://secure.marketdojo.com/api/v1/documentation  

  4. Prüfen Sie die verfügbaren Endpunkte, um zu verstehen, wie die API funktioniert.

  5. Beachten Sie, dass Sie die API direkt von der Dokumentationsseite aus ausprobieren können.

Was sind die Reporting-APIs?

Market Dojo bietet eine Reihe von API-Endpunkten, die für die Verwendung mit Reporting-Tools wie Power BI konzipiert sind.

Zusätzlich zu den unten aufgeführten Endpunkten finden Sie die Dokumentation zu den v1-API-Endpunkten unter https://gl.marketdojo.com/api/v1/documentation

Verwendung der Reporting-APIs

Anfragen müssen an folgende Adresse gerichtet werden:

- https://secure.marketdojo.com oder

- die von Ihrem Unternehmen konfigurierte Domain (z. B. https://acme.marketdojo.com oder https://procurement.acme.com).


Anfragen mit einem Host-Header für eine andere Domain werden blockiert.


Die Reporting-APIs benötigen 2 Standardparameter:

E-Mail : Die E-Mail-Adresse des Benutzers, der auf den Endpunkt zugreift.

api_key : Der API-Schlüssel des Benutzers (dieser ist auf der Profilseite in der Market Dojo-Anwendung zu finden).


Wenn Sie die Endpunkte über die Befehlszeile verwenden, müssen Sie die URL möglicherweise in Anführungszeichen setzen.


z.B

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


Die Ergebnisse werden im JSON-Format zurückgegeben.

Zu überprüfende Punkte

  • Ist der Benutzer Mitglied der (Standard-)Gruppe? Falls nicht, erhält er einen 403-Fehler.

Einen API-Schlüssel erhalten

Zur Nutzung der API ist ein API-Schlüssel erforderlich.

Folgen Sie den Anweisungen hier , um Ihren API-Schlüssel zu erhalten.

Falls Sie die Option zum Erstellen oder Anzeigen Ihres API-Schlüssels nicht sehen, bitten Sie Ihren Superhost, die API auf der Seite Admin > Integrationen zu aktivieren.


Verfügbare API-Endpunkte für die Berichterstellung

Unternehmen

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


Dieser Endpunkt liefert Informationen über das Unternehmen des Benutzers.

Benutzer

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


Dieser Endpunkt liefert Informationen über alle Benutzer im Unternehmen.

Verträge

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



Dieser Endpunkt liefert Details zu den Verträgen, auf die der Benutzer Zugriff hat.

Veranstaltungen

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


Dieser Endpunkt gibt Details zu den Ereignissen zurück, auf deren Anzeige der Benutzer Zugriff hat.

Fragebogen

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


Dieser Endpunkt liefert Details zu einem Fragebogen, einschließlich der eingegangenen Antworten.

HINWEIS: :id sollte durch die ID (eine Zahl) des Fragebogens ersetzt werden.

SIM-Teilnehmer

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


Dieser Endpunkt liefert Details zu den Teilnehmern einer Lieferanten-Onboarding-Veranstaltung.


SRM

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


Dieser Endpunkt liefert Details zur SRM-Suite eines Benutzers. Informationen wie srm_accounts, srm_contacts, Aktivitäten und Ereignisse.