MotimateMotimate Public API ドキュメントを Postman にインポートするには？

スクリーンショット 2025-03-11 at 17.37.47 copy.png

はじめに

API開発者であれば、アプリケーションの機能性と信頼性を保証するために、テストと文書化がいかに重要であるかをご存知だろう。 Postmanは、HTTPリクエスト、エンドポイントのテスト、レスポンスの可視化を行うためのユーザーフレンドリーなインターフェースを提供するため、開発者の間で人気のあるツールだ。

このツールの主な特徴のひとつは、Open API形式のドキュメントをインポートできることだ。この記事では、Motimate Public APIドキュメント（Open API 3.0形式）をPostmanコレクションにインポートする手順を説明し、APIのテストと開発を効率化します。

必要条件

始める前に、システムにPostmanをインストールしておく必要がある。ポストマンのダウンロードはこちらから。

Postmanコレクション用のMotimate APIをインポートします：

Motimate Public API ドキュメントのダウンロードページ(ここ) を参照してください。
右上にあるエクスポートボタンを見つけてクリックする。 Download APIを選択し、次にJSON Unresolvedを選択する。
ファイルをダウンロードしたら、Postmanを開く。
コレクション タブを開き、インポートをクリックします。ダウンロードしたファイルをコレクションとしてアップロードします。
Motimate Public APIをクリックし、変数タブを選択します。
clientIdという名前の新しい変数を追加し、初期値をMotimateから提供された値に設定します。現在値は自動的に更新されます。

では...

clientSecretという名前の新しい変数を追加し、初期値をMotimateから提供された値に設定します。現在値は自動的に更新されます。
非常に重要：保存をクリックします！
Motimate Public APIを再度クリックし、認証タブを選択します。
Typeを OAuth 2.0 に設定します。フォームが表示されるはずだ。 Configure New Token（新しいトークンの設定）セクションまでスクロールダウンしてください。

もし「Some changes to Token…」という情報が表示されたら、「Edit Token Configuration」をクリックしてください。
付与タイプをクライアント資格情報に設定する：
1. アクセストークンのURLを {{baseUrl}}/oauth/tokenに設定する。
2. クライアントIDを{{clientId}}
3. クライアント・シークレットを{{clientSecret}}
下にスクロールし、「Get New Access Token」をクリックします。 Postmanは認証が成功したことを知らせるはずだ。 Proceedをクリックし、Use Tokenをクリックする。
非常に重要：保存をクリックします！
クリック：私 →現在の組織を取得→送信。

Motimate Public APIからの応答が表示され、組織データが表示されます。

おめでとう！ これで Motimate Public API を Postman Collections にインポートできました。