Market Dojo API

Market Dojo API

あなたが直面している問題は何ですか?

Market DojoのAPIに接続したいのですが、どうすればよいでしょうか?

解決

Market DojoにはAPIを使用してプログラムからアクセスできます。

手順

  1. Market Dojoにログイン

  2. プロフィールページにアクセスし、 メールアドレスMarket Dojo APIキーをメモしてください。

  3. https://secure.marketdojo.com/api/v1/documentationにアクセスしてください。  

  4. APIの仕組みを理解するために、利用可能なエンドポイントを確認してください。

  5. ドキュメントページから直接APIを試すことができることに注意してください。

レポート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、アクティビティ、イベントなどの情報が含まれます。




    • Related Articles

    • Market Dojoアカウントの登録方法

      あなたが直面している問題は何ですか? Market Dojoのアカウントを作成したいのですが、どうすればいいですか? 解決 Market Dojoアカウントに登録するには: こちら (https://secure.marketdojo.com/signup )にアクセスし、メールアドレスを入力して「始める」ボタンをクリックしてください。 次に、ホスト(購入者)アカウントか参加者(供給者)アカウントのどちらを作成するかを決定する必要があります。 ...
    • 退職したユーザーや、Market Dojoへのアクセスが不要になったユーザーへの対応方法を教えてください。

      あなたが直面している問題は何ですか? 退職したユーザーがいます。Market Dojoでユーザーを無効化するにはどうすればよいですか? 解決 ユーザーが退職し、そのユーザーを無効化する必要がある場合は、以下の手順に従ってください。 スーパーホストアカウント、またはホストグループの権限変更を許可したアカウントを使用して、Market Dojoポータルにログインしてください。 [管理者] > [ホストグループ] をクリックします。 無効化されたホストグループを検索します ...
    • Spend HQとの連携設定方法(Per Angusta)

      Market DojoとSpend HQの両方を使用している場合は、両システム間の連携を有効にすることができます。 これにより、 再度ログインせずに、一方のデバイスからもう一方のデバイスへ移動する - Spend HQ内からMarket Dojoイベントを作成する - Market Dojoイベントによる節約額をSpend HQに報告する 統合を可能にする 以下の手順についてご不明な点がある場合は、マーケットドージョのサポートチームまでお問い合わせください。 統合を有効にする ...
    • Per Angustaとの連携を有効にするにはどうすればよいですか?

      あなたが直面している問題は何ですか? Spend HQ(Per Angusta)とMarket Dojoの連携を有効にしたいのですが、どうすればよいでしょうか? 解決 Market DojoとPer Angustaの両方を使用している場合は、両システム間の連携を有効にすることができます。 これにより、 再度ログインせずに、一方のデバイスからもう一方のデバイスへ移動する - Per Angusta内からMarket Dojoイベントを作成する - ...
    • OktaとのSSO統合の設定方法

      あなたが直面している問題は何ですか? Market DojoとOktaの連携を設定したいのですが、どうすればよいでしょうか? 解決 Oktaは何をしていますか? Oktaは、組織がセキュリティを一元的に管理することを可能にする。 エンドユーザーにとってそれが何を意味するのかを説明する動画はこちらです。 https://screencast.com/t/GKzEGtJF3VA9 このガイドの残りの部分では、OktaをMarket Dojoと連携させる方法について説明します。 Oktaの設定 ...