Slide 1

Slide 1 text

ぼくのかんがえたさいきょうの Postmanかんきょう
 株式会社dott とみぎ


Slide 2

Slide 2 text

自己紹介


Slide 3

Slide 3 text

自己紹介
 名前: 谷口泰大
 ニックネーム: とみぎ
 所属: 株式会社dott
 仕事: サーバーサイドのシステム開発
 最近使う言語: Python, node.js
 好きなこと: 効率化ツール探し


Slide 4

Slide 4 text

今日は
 Postmanの環境設定例を紹介します


Slide 5

Slide 5 text

Agenda
 ● Environmentを使おう
 ● Collection設定を活用しよう
 ● Testsで楽しよう


Slide 6

Slide 6 text

TL;DR(要約)
 ● Environmentを使って環境毎のURLやトークンを管理する
 ● CollectionのVariables・Authを使ってコレクションに依存する値の 管理をする
 ● Testsのスクリプトを使ってEnvironmentの値更新を自動化する


Slide 7

Slide 7 text

Environmentを使おう


Slide 8

Slide 8 text

About Environment
 PostmanのEnvironmentはいわゆる環境変数のような立ち位置で、コレクション全体 で参照が可能である


Slide 9

Slide 9 text

About Environment
 Environmentの変数は以下の目的でよく使っている
 ● APIのホストURL(パスを除いたもの)の指定
 ● アクセストークンの保持
 ● プルリクのデプロイバージョン番号の指定


Slide 10

Slide 10 text

環境毎にEnvironmentを分ける


Slide 11

Slide 11 text

環境毎にEnvironmentを分ける
 ● LOCAL: 
 ● DEV: 
 ● STG: 
 ● PROD: 


Slide 12

Slide 12 text

環境毎にEnvironmentを分ける
 ● LOCAL: ローカル環境用
 ● DEV: 開発環境用
 ● STG: ステージング環境用
 ● PROD: 本番環境用


Slide 13

Slide 13 text

Environment: LOCAL, STG, PROD
 → (ex.) localなら http://0.0.0.0:8080


Slide 14

Slide 14 text

Environment: DEV


Slide 15

Slide 15 text

Environment: DEV


Slide 16

Slide 16 text

Environmentを使うことで APIの接続先の切り替えがスムーズに!

Slide 17

Slide 17 text

Collection設定を活用しよう


Slide 18

Slide 18 text

CollectionVariablesにAPIパスを設定


Slide 19

Slide 19 text

設定例
 普通にリクエストのURLを設定した場合 
 host path

Slide 20

Slide 20 text

設定例
 Environmentを使ってみる
 path

Slide 21

Slide 21 text

設定例

Slide 22

Slide 22 text

設定例 CLI のSERVICE_PATHには、 /_ah/api/cli/v1 を設定

Slide 23

Slide 23 text

設定例 SYS のSERVICE_PATHには、 /_ah/api/sys/v1 を設定

Slide 24

Slide 24 text

URLの設定

Slide 25

Slide 25 text

設定後の値 CLI

Slide 26

Slide 26 text

設定後の値(SYS)

Slide 27

Slide 27 text

Collection Variables活用まとめ

Slide 28

Slide 28 text

Authorizationを使う
 Collectionには認証情報の設定 もでき、これもVariables同様 Collection配下のリクエストに対 して認証情報を一括で付与する ことが出来ます
 


Slide 29

Slide 29 text

Authorizationを使う

Slide 30

Slide 30 text

Authorizationを使う

Slide 31

Slide 31 text

Testsで楽しよう


Slide 32

Slide 32 text

Testsにアクセストークンを自動で更新させる


Slide 33

Slide 33 text

Testsにアクセストークンを更新するスクリプトを追加する

Slide 34

Slide 34 text

Testsにアクセストークンを更新するスクリプトを追加する

Slide 35

Slide 35 text

解説

Slide 36

Slide 36 text

解説

Slide 37

Slide 37 text

このTestsの設定をする事で、
 Environmentのパラメータを書き換える作業から解放さ れます(※プロジェクトによります) 


Slide 38

Slide 38 text

TL;DR(おさらい)
 ● Environmentを使って環境毎のURLやトークンを管理する
 ● CollectionのVariables・Authを使ってコレクションに依存する値 (APIのパス)や認証情報(トークン)の管理をする
 ● Testsのスクリプトを使ってEnvironmentの値更新を自動化する


Slide 39

Slide 39 text

以上が最強のPostman環境構築の
 解説になります
 ...

Slide 40

Slide 40 text

...

Slide 41

Slide 41 text

最後に...#PR 
 one more push!

Slide 42

Slide 42 text

#PR: AI STUDIO


Slide 43

Slide 43 text

#PR: AI STUDIO とは
 everyone programming expert 3種類のコースでAIを学ぶための教材を提供しています 興味のある方はdottのHPよりお問い合わせください → 一般教養としての知識を身に着けたい人 コードを書いてAIのAPIを使った システム開発がしたい人 AIのモデル作成など よりコアな技術・知識を身に着けたい人

Slide 44

Slide 44 text

Thank you!!