はじめに｜「アサーション」って、思っていたより怖かった
Postman と EchoAPI で、
いちばん基本的なアサーションを追加すると、体験はどう違うのか？
経験者にとっては「数行書くだけ」の作業かもしれません。
でも、私のような新人にとっては、この一歩が——
「API テスト、続けられるかどうか」を左右する瞬間
になると、本気で思いました。
以下は、そのときのかなり正直な体験談です。
EchoAPI｜コードを書かずに「アサーションが通った」驚き
AI の提案から、アサーションという存在を知る
レスポンスを眺めていたとき、ふとこんな疑問が浮かびました。
「このレスポンスって……
本当に“正しい”って、どうやって判断するんだろう？」
すると、レスポンス欄にマウスを置いた瞬間、
「AI アサーション」 という見慣れないボタンが表示されました。
正直、この時点では
「アサーションって何をするものか」も、よく分かっていません。
それでも、
「とりあえず押してみよう」と思えたのは、
UI があまりにも自然だったからです。
クリックしてみると、AI が自動で複数のアサーションを生成。
しかも、それぞれに 日本語の説明付き。
この瞬間、私は内心こう思いました。
「あ、日本語で書いてあるだけで、
こんなに安心感が違うんだ……」
「後処理」に緑の点。ちゃんと“動いた”感覚
そのまま挿入すると、「後処理」に緑の点が表示されました。
クリックしてみると、さっき AI が作ったアサーションが
そのまま、もう入っている。
ここで私は、少し驚きました。
- 書いてない
- コードも読んでない
- でも、もう設定が終わっている
そして 送信。
結果は、画面下の【テスト結果】エリアに
はっきりと表示されました。
「どこを見ればいいのか」で迷わない。
これは新人にとって、本当に大きいです。
「理解してなくても、体験できた」ことの価値
このとき、私は強く感じました。
スクリプトが書けなくても、
ロジックが完全に分からなくても、
「アサーションを一度通す」体験はできる。
この「一度できた」という感覚があるかどうかで、
その後の学習意欲は、かなり変わると思います。
可視化アサーション｜「これなら分かる」と思えた瞬間
さらに後処理のプルダウンを見ていると、
その中にそのまま 【アサーション】 という項目がありました。
最初は意味が分かりませんでした。
でも、よく見ると気づいたんです。
ここに出ている選択肢、
すべて下のレスポンスと1対1で対応している……？
たとえば、レスポンスに lang: en があれば、
lang = en を選ぶだけ。
この瞬間、頭の中でこう思いました。
「あ、これは“考えなくても選べる”やつだ」
成功表示を見たときの、ちょっとした達成感
送信すると、すぐに結果が表示されました。
「テスト成功」
探す必要もなく、
「合ってるのか？失敗してるのか？」と悩む余地もありません。
そのとき、私は思わず心の中でつぶやきました。
「……自分でも、ちゃんとアサーションできたんだ」
たった一つでも、
自分の手でテストを“成立させた”感覚は、想像以上に大きかったです。
Postman｜最初の感想は、正直「無理かも……」
アサーションの入口が、まず分からない
次に Postman を開いて、同じことをやろうとしました。
……が、
どこにアサーションがあるのか分からない。
調べてようやく分かったのが、
「Script → Post-response に入る」
という手順でした。
そこで画面を開いた瞬間、
私は現実を突きつけられます。
JavaScript 前提。
そのときの率直な気持ちは、これです。
「あ、これは一気にハードル上がった……」
「自分、ここで詰むタイプかもしれない」
「Ask AI」にすがる新人心理
画面の隅に、小さく書かれた 「Ask AI」。
正直、かなり見つけにくいです。
でも、このときの私は、
「自分で書けないなら、
AI に頼るしかない」
という、完全に新人ムーブ。
「アサーションしてください。」とだけ入力しました。
コピペはできた。でも、理解はゼロ
AI はすぐに大量の JavaScript を生成してくれました。
……全部英語。
正直、
何をチェックしているのか、ほぼ分かりません。
approve → 送信。
すると今度は、こんな状態に。
- どこに結果が出ているのか分からない
- 成功なのか失敗なのか分からない
- そもそも、今何が起きているのか分からない
そのときの感情を一言で言うなら——
挫折感。
「自分は API テストに向いてないのかも」と、
一瞬、本気で思いました。
しばらく画面を探し回って、
ようやく「ボディ」のプルダウンの中に結果があることに気づきました。
やっと結果にたどり着いたものの……
（なぜここも全部英語なんだろう……日本語対応してほしい……）
後日談｜EchoAPI の Script 機能を見て、納得した
Postman で Script を使ったあと、
ふと「EchoAPI にも Script あったよな？」と思い出し、
改めて開いてみました。
すると、そこには3つの選択肢。
- コードを書く
- 常用スクリプト
- AI生成スクリプト
この並びを見た瞬間、私は腑に落ちました。
「あ、逃げ道がちゃんと用意されてるんだ」
「とりあえず動かしたい新人」への配慮
私は迷わず 常用スクリプト を選択。
そのときの心境は、まさにこれ。
「理屈は後でいい。
まずは一回、成功体験がほしい」
送信すると、そのまま【テスト結果】が表示。
この瞬間、
EchoAPI は“できる人”だけのツールじゃないと、はっきり分かりました。
まとめ｜新人にとっての「最初のアサーション体験」の差
| 項目 | Postman | EchoAPI |
|---|---|---|
| 追加方法 | JS 前提 | 可視化・ノーコード可 |
| 学習コスト | 高い | 低い |
| 結果の分かりやすさ | 迷う | 一目で分かる |
| 新人の心理 | 不安・挫折しやすい | 安心・続けられる |
私の率直な結論
-
Postman：
「何をしているか分かる人」向け -
EchoAPI：
「まず体験させてくれる」設計
もしあなたが、
- API テストをこれから始める人
- JavaScript にまだ自信がない人
- 「アサーションって何？」の段階にいる人
なら、
最初の一歩として EchoAPI を選ぶのは、かなり心が軽くなる
——私はそう思いました。
あなたは、
「最初から理解して進みたい派」ですか？
それとも
「まず成功体験がほしい派」ですか？
きっと、その答えで、向いているツールも変わるはずです。