Postman から移行する

1. Postman からエクスポートする

Postman で Collection ▸ … ▸ Export ▸ Collection v2.1 を選びます。環境も同じ手順でエクスポートしてください。

ファイル ▸ インポート（Ctrl+I）を開き、その JSON ファイルを指定します。 Restorm は形式を自動で判別します。

Postman	Restorm
フォルダー	同じ階層のフォルダー
HTTP リクエスト	HTTP リクエスト
GraphQL リクエスト	GraphQL リクエスト（HTTP リクエストではありません）
raw、formdata、urlencoded、file、graphql のボディ	対応するボディの種類
コレクション変数	環境の変数
説明	メモと API ドキュメント
レスポンスの例	API ドキュメント
プリリクエストスクリプトとテストスクリプト	`pm.` 互換レイヤーを備えた実行可能なシナリオ*

Postman の認証ブロックは ドキュメント化 されます（機密値はマスクされます）が、実行可能な認証情報には変換されません。

認証リクエストを作り直してください。 5 分ほどの作業で、トークンの自動更新と 401 での再試行が手に入ります。 Postman はこれを自動では行いません。

Postman からエクスポートし、変数フォルダーの中に作り直します。

この機会に サブ環境 を活用してください。Postman ではターゲットごとにフラットな環境を用意する必要がありますが、Restorm では共通のベースを置き、顧客ごとやリージョンごとに上書きできます。

これが最も見返りの大きい置き換えです。シナリオはランナーと同じことを、より良い形で行います。

Postman	Restorm
Workspace	git で管理される `.restorm` のプロジェクト
Collection	フォルダーまたは変数フォルダー
Environment	変数フォルダーの中の環境
Globals	子に継承されるルート環境
Pre-request / Test script	シナリオ、またはコードアクション
Collection Runner	シナリオ
Newman	`restorm --run --headless`
Mock Server	ローカルで動くサーバーモード
Monitors	タイマーアクション、または CI のスケジュール実行タスク
Postman Console	コンソール
動的変数 `{{$random…}}`	同じもの、さらに 116 個のヘルパー — リファレンスを参照

リクエストが、リポジトリの中の ファイル になります。コードと同じレビューサイクルに乗り、その履歴は git の履歴そのもので、アクセス権はホスティングサービスの権限がそのまま適用されます。

管理すべきホスト型ワークスペースはなく、API のデータが第三者のサービスに置かれることもありません。プロジェクトと .restorm ファイルを参照してください。

正直に書きます。Restorm には、ホスト型の共同ワークスペース、公開 API ポータル、リクエストへのインラインコメント、ホスト型のモニタリングがありません。組織がこれらに依存している場合、直接の代替はありません。共有は git を通じて行います。