Market Dojoにログイン
プロフィールページにアクセスし、 メールアドレスとMarket Dojo APIキーをメモしてください。
https://secure.marketdojo.com/api/v1/documentationにアクセスしてください。
APIの仕組みを理解するために、利用可能なエンドポイントを確認してください。
ドキュメントページから直接APIを試すことができることに注意してください。
Market Dojoは、Power BIなどのレポート作成ツールで使用するために設計された多数のAPIエンドポイントを提供しています。
下記に記載されているエンドポイントに加え、v1 APIエンドポイントのドキュメントはhttps://gl.marketdojo.com/api/v1/documentationでご覧いただけます。
リクエストは以下のいずれかに提出する必要があります。
- https://secure.marketdojo.com、または
- 貴社が設定したドメイン(例: https://acme.marketdojo.comまたはhttps://procurement.acme.com)。
他のドメインのホストヘッダーを含むリクエストはブロックされます。
レポートAPIは、2つの標準パラメータを受け取ります。
メールアドレス: エンドポイントにアクセスしているユーザーのメールアドレス
api_key :ユーザーのAPIキー(マーケットプレイス道場アプリケーションのユーザープロフィールページで確認できます)
コマンドラインからエンドポイントを使用する場合は、URLを引用符で囲む必要がある場合があります。
curl ' https://secure.marketdojo.com/api/v2/reports/contracts?email=email&api_key=api_key '
結果はJSON形式で返されます。
ユーザーは(デフォルトの)グループのメンバーですか?そうでない場合は、403エラーが返されます。
APIを使用するにはAPIキーが必要です。
APIキーを取得するには、 こちらの指示に従ってください。
APIキーの作成または表示オプションが表示されない場合は、スーパーホストに「管理」>「統合」ページでAPIを有効にするよう依頼してください。
https://secure.marketdojo.com/api/v2/reports/companies?email=email&api_key=key
このエンドポイントは、ユーザーの会社に関する情報を返します。
https://secure.marketdojo.com/api/v2/reports/users?email=email&api_key=key
このエンドポイントは、社内の全ユーザーに関する情報を返します。
https://secure.marketdojo.com/api/v2/reports/contracts?email=email&api_key=key
このエンドポイントは、ユーザーが閲覧権限を持つ契約の詳細を返します。
https://secure.marketdojo.com/api/v2/reports/events?email=email&api_key=key
このエンドポイントは、ユーザーが閲覧権限を持つイベントの詳細を返します。
https://secure.marketdojo.com/api/v2/reports/questionnaires/:id?email=email&api_key=key
このエンドポイントは、アンケートの詳細(受信した回答を含む)を返します。
注::id はアンケートの ID(番号)に置き換えてください。
https://secure.marketdojo.com/api/v2/reports/sim_participants?email=email&api_key=key
このエンドポイントは、サプライヤーのオンボーディングイベントの参加者の詳細を返します。
https://secure.marketdojo.com/api/v2/reports/srm?email=email&api_key=key
このエンドポイントは、ユーザーのSRMスイートの詳細を返します。srm_accounts、srm_contacts、アクティビティ、イベントなどの情報が含まれます。