レポートAPIとは何ですか？

Market Dojoは、Power BIなどのレポート作成ツールで使用するために設計された多数のAPIエンドポイントを提供しています。

下記に記載されているエンドポイントに加え、v1 APIエンドポイントのドキュメントはhttps://gl.marketdojo.com/api/v1/documentationでご覧いただけます。

レポートAPIを使用する

リクエストは以下のいずれかに提出する必要があります。

- 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キーの作成または表示オプションが表示されない場合は、スーパーホストに「管理」>「統合」ページで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（番号）に置き換えてください。

SIM参加者

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

このエンドポイントは、サプライヤーのオンボーディングイベントの参加者の詳細を返します。

SRM

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

このエンドポイントは、ユーザーのSRMスイートの詳細を返します。srm_accounts、srm_contacts、アクティビティ、イベントなどの情報が含まれます。