menu

【モックサーバー】httpbinの使い方

公開日:2023年09月14日 カテゴリー:コラム, 開発

みなさんは「特定のHTTPレスポンスを返してくれるモックサーバーがほしいけど、自分で作る余裕はない」というときはありませんか?
今回はそんなときに便利なWebサービス「httpbin」をご紹介いたします。

httpbinとは

このサービスは、その名の通りHTTPに関するあらゆることができるモックサーバーで、無料で使うことができます。
URLは以下の通りです。

httpbin.org

できること

httpbinは以下のことができます。

  • クライアントのIPアドレスの確認
  • クライアントのuser-agentの確認
  • GET、POST、PATCH、PUT、DELETEで送信したパラメーターとヘッダーの確認
  • 任意のレスポンスコードを返す
  • ベーシック認証のテスト
  • cookieのテスト
  • 遅延レスポンス(タイムアウト時間)の確認

では、順に説明しましょう。

クライアントのIPアドレスの確認

httpbin.org/ip

たったこれだけで確認できます。

クライアントのuser-agentの確認

次はuser-agentの確認をしてみましょう。以下のURLで確認可能です。

httpbin.org/user-agent

GET、POST、PATCH、PUT、DELETEで送信したパラメーターとヘッダーの確認

ここからが本領発揮です。例えば、GET通信のテストをする場合は以下のようにします。

httpbin.org/get?hoge=fuga

同様にそれぞれのメソッドを以下のURLで確認できます。

メソッド URL
GET https://httpbin.org/get
POST https://httpbin.org/post
PATCH https://httpbin.org/patch
PUT https://httpbin.org/put
DELETE https://httpbin.org/delete

任意のレスポンスコードを返す

以下の書式で任意のレスポンスコードを取得することができます。

https://httpbin.org/status/{code}

例えば以下のようなことが可能です。

ベーシック認証のテスト

以下の書式でbasic認証のテストができます。

https://httpbin.org/basic-auth/{id}/{pass}

例えば以下のURLでIDがtest、パスワードが1234のbasic認証をテストできます。

https://httpbin.org/basic-auth/test/1234

cookieのテスト

httpbinを使うことで、set-cookieヘッダーのモックを作ることも可能です。

https://httpbin.org/cokkies/set/{key}/{value}

以下のURLの場合、keyがhoge、valueがfugaのレスポンスが返ってきます。

https://httpbin.org/cookies/set/hoge/fuga

もちろん、cookie情報を取得することもできます。

https://httpbin.org/cookies

遅延レスポンス(タイムアウト時間)の確認

タイムアウトになるプログラムを組んだけど、正しく動くか心配。でも大丈夫。そう、httpbinならね。

https://httpbin.org/delay/{sec}

例えば10秒後にレスポンスが欲しいときは以下のようにします。

https://httpbin.org/delay/10

その他

これだけではありません。さらにいろいろなことができるのでざっくり紹介します。

できること URL
昔のWebページ風サイトを表示 https://httpbin.org/legacy
HTMLのページを表示 https://httpbin.org/html
robots.txtを表示 https://httpbin.org/robots.txt
uuidを取得 https://httpbin.org/uuid
HTTPヘッダーを返却 https://httpbin.org/headers
10秒(数字は任意)後にリダイレクト https://httpbin.org/redirect/10
10個(数字は任意)のjsonを取得 https://httpbin.org/stream/10
レスポンスヘッダーを取得 https://httpbin.org/response-headers
base64に変換(ここでは「こんにちは」を変換) https://httpbin.org/base64/こんにちは
bearer認証の確認 https://httpbin.org/bearer
指定したバイト数のレスポンス(ここでは1024バイト) https://httpbin.org/bytes/1024
cacheの取得 https://httpbin.org/cache
指定したバイト数のレスポンスを連続で返す https://httpbin.org/stream-bytes/1024
画像を取得 https://httpbin.org/image
指定した拡張子(ここではjpg)の画像を取得 https://httpbin.org/image/jpeg
xmlでレスポンス https://httpbin.org/xml

などなどたくさんあります。
詳細は、githubをご確認ください。
https://github.com/postmanlabs/httpbin

 

最後までご覧くださり、ありがとうございました。

 

ウィズテクノロジーで一緒に働きませんか?
分野を限定せず幅広い事業を展開。新しい技術の導入にも積極的に取り組んでおり、チャレンジや成長する機会が沢山。
あなたの経験・知識を活かしながら一緒にIT業界を盛り上げて行きましょう!
採用情報詳細はコチラ