LoginSignup
3

More than 3 years have passed since last update.

LINE WORKS API を Postman でコールしてみる(準備編)

Last updated at Posted at 2020-01-14

0. はじめに

本記事は下記の3回に分けて Postman を使用した LINE WORKS API のコール方法を書きまーす。

本記事は、準備編になります。
準備編の流れは下記の通りです。

  1. こんなの作ります
  2. まずは、Developer Console の設定
  3. GitHubからPostmanの設定データをインポート
  4. Postmanに設定している環境変数の説明と設定
  5. まとめ

1.こんなの作ります

Postman を使用して、LINE WORKS の Server API と Service API をコールする環境を 準備編 + Server API 編 + Service API 編で作ります。
面倒な Access Token も Postman で取得・保持する方法も載せちゃいます。
※現状は、Postman ですべての API をコールする状態ではありません。Postman の設定情報を更新した際は Export して GitHub の line-works-postman の push して行こうと思っていますので watch していただければ幸いです。(twitterでもつぶやきますので@shotamaco1フォロー願います)
goal.png

2.まずは、Developer Console の設定

LINE WORKS API コールに必要な下記のデータを Developer Console の設定を行って取得しておく。
これらのデータを Postman の Enviroment に設定するので重要。

  • Domain ID
  • API ID
  • Service API Consumer Key
  • Server API Consumer Key
  • Server List(ID登録タイプ)
    • ID
    • 認証キー

console01.png
console02.png

Service API Consumer Key 発行時の設定

いずれすべてのAPIをコールする予定なので、すべての項目をONにする。
ServiceApiConsumerKeySelect.png

Tokenの有効期限は適当でOK。Postmanで簡単にTokenを取得するようにするので。
ServiceApiCunsumerKeyDate.png

Server API Consumer Key 発行時の設定

いずれすべてのAPIをコールする予定なので、すべての項目をONにする。(カレンダーの照会はONにできない。。。)
ServerApiConsumerKeySelect01.png
ServerApiConsumerKeySelect02.png

Tokenの有効期限は適当でOK。Postmanで簡単にTokenを取得するようにするので。
ServerApiConsumerKeyDate.png

3.設定ファイルをPostmanにインポート

GitHub の line-works-postman リポジトリのPostman 設定ファイルをローカルの Postman にインポートします。

LINE WORKS 用の Workspace 作成

まずは Postman に LINE WORKS 用の Workspace を作成します。Workspace 名は適当でOK。

「Create New」をクリック。
postman01.png

「Name」(Workspace名)を適当に入力。「Create Workspace」をクリック。
postman02.png

LINE WORKS 用の Worksplace が作成されました。
postman03.png

GitHubから設定ファイルをダウンロード

GitHub より line-works-postman をクローンまたはダウンロードします。(今回はダウンロードのする方法で説明します)
gitdownload.png

ダウンロードしたZIPを回答すると下記の構成になっています。
gitpostgman.png

Environment ファイルのインポート

ローカルの Postman に Enviroment ファイルをインポートします。

「Manage Environments」ボタンをクリック。
postman040.png

「Import」ボタンをクリック。
postman04.png

「ファイル選択」ボタンをクリック。
postman05.png

ダウンロードし解答した「Environments/DomainEnv.postman_environment.json」を選択して「開く」をクリック。
postman051.png

DomainEnvが追加されればOK!
postman06.png

Collection ファイルをインポート

ローカルの Postman に Server API と Service API の Collection ファイルをインポートします。

「Import」ボタンをクリック。
postman101.png

「Choose Files」ボタンをクリック。
postman102.png

ダウンロードし解答した「Collections/Server APIs.postman_collection.json」と「Collections/Service APIs.postman_collection.json」を選択して「開く」をクリック。
postman103.png

Server API と Service API の Collection が表示されればOK!
postoman103.png

4.Postman 環境変数の説明と定義

Postman の Environment と Collection に Variable (変数)を定義しています。
各変数の値を自分の LINE WORKS の環境の値に変えれば、すぐに API をコールすることができる感じです。

Environment 説明と定義

Environment には、おもに LINE WORKS API を使用する際に必要な Developer Console で発行した情報等を設定するようにしています。
また、Server API、Service API 共通で使用する画像やアカウントIDを登録しています。
Environment は、Domain 単位で定義することにより API のコール先を簡単に切り替えれることを目的に使ってます。
Environment の変数定義の命名規則は、すべて大文字で単語をアンダースコアでつないでます。例えば、DOMAIN_ID、API_ID の用になります。
「Manage Environments」ボタンをクリック。
postman040.png

「DomainEnv」をクリック。
postman06.png

各値を修正して「Update」をクリック。
※ ドメイン名は LINE WORKS にログインする際の @ 以降の文字列です。(ログインIDが sample01@works-qiita の場合 、ドメイン名は works-qiita です)
postman106.png

編集した Environment を選択します。
postman025.png

Collection 説明

Collection には、おもに API 実行結果を変数にセットして、次の API で使用する場合に使用しています。
例えば、Bot 登録 API をコールした結果 Bot No が Response されるのでそれを Postman の Tests で Collection の変数に登録してます。
Collection の変数定義の命名規則は、すべて大文字で単語をアンダースコアでつないでます。例えば、bot_no_01、access_token の用になります。
「Server APIs」の「・・・」をクリックし、「Edit」をクリック。
postman105.png

「Variables」タブをクリック。ここでは特に修正する必要はありません。
※ API コールの結果が登録されるためAPIをコールしていない場合は何も定義されていないかもです。
スクリーンショット 2020-01-15 0.52.06.png

5. まとめ

以上で準備完了でーす。

Environment の変数は大文字、Collection の変数は小文字にすることによって、Request でどちらの変数を使用しているかをひと目で分かるようにしています。
postman201.png

ここまでくれば、Server API は、上から順番に Request を Send すれば、APIをコールできます。
詳しい使い方は、次回「LINE WORKS API を Postman でコールしてみる(Server API編)」で書きたいと思います。
Service API の方は、Access Token の取得設定をしていない(正確には、Postman に OAuth の設定をしてもエクスポートするすべがない。。。)ので使用できません。
なので「LINE WORKS API を Postman でコールしてみる(Service API編)」で書こうと思います。

Link

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
What you can do with signing up
3