中級者向け No.28

REST APIテスター

GET/POST/PUT/DELETEリクエストを送信してレスポンスを確認できるAPIテストツール。Postman風のUIを実装します。

🎯 難易度: ★★☆ 📦 ライブラリ: tkinter（標準ライブラリ）のみ ⏱️ 制作時間: 30〜90分

📋 目次

1. アプリ概要
2. 機能一覧
3. 事前準備・環境
4. 完全なソースコード
5. コード解説
6. ステップバイステップガイド
7. カスタマイズアイデア
8. よくある問題と解決法
9. 練習問題

1. アプリ概要

GET/POST/PUT/DELETEリクエストを送信してレスポンスを確認できるAPIテストツール。Postman風のUIを実装します。

このアプリは中級カテゴリに分類される実践的なGUIアプリです。使用ライブラリは tkinter（標準ライブラリ）、難易度は ★★☆ です。

このアプリは「ネットワーク」カテゴリです。ネットワーク連携は Python の代表的な活用領域で、I/O 待ちと UI 更新の関係や非同期処理の考え方が他の Web API 連携にも直接活きます。tkinter（標準ライブラリ） を活かして実装するこの構造は、他のアプリにも応用が効きます。

動かしながら読むことが理解の最短経路です。まずはコードをコピーして実行し、想定どおりに動くことを確認したうえで解説と照らし合わせてください。

カスタマイズでは「機能追加」「UI 改善」「エラー耐性」の三方向で考えると視野が広がります。練習問題にもそれぞれの方向の具体例を用意しています。

REST APIテスター実行画面（Windows） — 実行画面（Windows）

REST APIテスター実行画面（Linux Mint） — 実行画面（Linux Mint）

2. 機能一覧

「▶ 送信」ボタン（_send()）で操作
キー <Return> から _send() を実行
イベント <<ComboboxSelected>> から _load_sample() を実行
マウス操作 <Double-1> から _load_history() を実行
tk.Listbox による一覧表示（スクロールバー付き）
messagebox.showwarning() によるダイアログ通知
ウィンドウはタイトル「REST APIテスター」・サイズ 960x680 で起動

3. 事前準備・環境

ℹ️

動作確認環境

Python 3.10 以上 / Windows 11（実機）で起動・基本操作を確認／ Linux Mint 22.3（仮想マシン）で起動・画面表示を確認（macOS は未検証）

Windows 11（実機）で起動と基本操作を確認しています（全機能の網羅テストではありません）。Linux Mint 22.3（仮想マシン）では起動と画面表示を確認しました。macOS は標準ライブラリの範囲で動作する想定ですが、未検証です。

Python 3.10 以上
OS: Windows 11（実機で起動・基本操作を確認）・Linux Mint 22.3（仮想マシンで起動・画面表示を確認）

このアプリは送信先へ実際に通信します。起動直後の URL 欄と「サンプル:」には外部の公開テストサービス（jsonplaceholder.typicode.com・httpbin.org）が入っているため、「▶ 送信」を押すとインターネット接続が必要です。提供元の規約と利用量の上限に従い、試し打ちは自分のパソコンで動かしたテスト用サーバー（python -m http.server 8000）へ向けてください。仕事のデータや認証情報をボディ・認証タブに入れたまま外部へ送らないでください（詳しくは9章）。

4. 完全なソースコード

💡

コードのコピー方法

右上の「コピー」ボタンをクリックするとコードをクリップボードにコピーできます。

✅ 追加インストール不要（標準ライブラリのみ使用）

app28.py

import tkinter as tk
from tkinter import ttk, messagebox
import json
import threading
import urllib.request
import urllib.error
import urllib.parse
from datetime import datetime


class App28:
    """REST APIテスター"""

    METHODS = ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"]
    SAMPLE_APIS = {
        "JSONPlaceholder - 記事一覧": ("GET", "https://jsonplaceholder.typicode.com/posts", ""),
        "JSONPlaceholder - ユーザー": ("GET", "https://jsonplaceholder.typicode.com/users/1", ""),
        "JSONPlaceholder - POST": ("POST", "https://jsonplaceholder.typicode.com/posts",
                                   '{"title":"テスト","body":"本文","userId":1}'),
        "HTTPBin - GET": ("GET", "https://httpbin.org/get", ""),
        "HTTPBin - ヘッダー確認": ("GET", "https://httpbin.org/headers", ""),
    }

    def __init__(self, root):
        self.root = root
        self.root.title("REST APIテスター")
        self.root.geometry("960x680")
        self.root.minsize(960, 680)
        self.root.configure(bg="#1e1e1e")
        self._history = []
        self._build_ui()

    def _build_ui(self):
        # ヘッダー
        header = tk.Frame(self.root, bg="#252526", pady=8)
        header.pack(fill=tk.X)
        tk.Label(header, text="🔌 REST APIテスター",
                 font=("Noto Sans JP", 13, "bold"),
                 bg="#252526", fg="#4fc3f7").pack(side=tk.LEFT, padx=12)

        # URL入力バー
        url_frame = tk.Frame(self.root, bg="#1e1e1e", pady=6)
        url_frame.pack(fill=tk.X, padx=8)
        self.method_var = tk.StringVar(value="GET")
        method_cb = ttk.Combobox(url_frame, textvariable=self.method_var,
                                  values=self.METHODS, state="readonly", width=9)
        method_cb.pack(side=tk.LEFT, padx=4)
        self.url_var = tk.StringVar(value="https://jsonplaceholder.typicode.com/posts/1")
        url_entry = ttk.Entry(url_frame, textvariable=self.url_var,
                               font=("Arial", 11), width=60)
        url_entry.pack(side=tk.LEFT, fill=tk.X, expand=True, padx=4)
        url_entry.bind("<Return>", lambda e: self._send())
        self.send_btn = ttk.Button(url_frame, text="▶ 送信",
                                    command=self._send)
        self.send_btn.pack(side=tk.LEFT, padx=4)

        # サンプル選択
        sample_frame = tk.Frame(self.root, bg="#1e1e1e", pady=2)
        sample_frame.pack(fill=tk.X, padx=8)
        tk.Label(sample_frame, text="サンプル:",
                 bg="#1e1e1e", fg="#8b949e").pack(side=tk.LEFT)
        self.sample_var = tk.StringVar()
        sample_cb = ttk.Combobox(sample_frame, textvariable=self.sample_var,
                                  values=list(self.SAMPLE_APIS.keys()),
                                  state="readonly", width=30)
        sample_cb.pack(side=tk.LEFT, padx=4)
        sample_cb.bind("<<ComboboxSelected>>", self._load_sample)

        # メインエリア
        paned = ttk.PanedWindow(self.root, orient=tk.HORIZONTAL)
        paned.pack(fill=tk.BOTH, expand=True, padx=4, pady=4)

        # 左: リクエスト設定
        left = tk.Frame(paned, bg="#1e1e1e")
        req_notebook = ttk.Notebook(left)
        req_notebook.pack(fill=tk.BOTH, expand=True)

        # ヘッダータブ
        headers_tab = tk.Frame(req_notebook, bg="#1e1e1e")
        req_notebook.add(headers_tab, text="ヘッダー")
        self._build_headers_tab(headers_tab)

        # ボディタブ
        body_tab = tk.Frame(req_notebook, bg="#1e1e1e")
        req_notebook.add(body_tab, text="ボディ")
        tk.Label(body_tab, text="Content-Type:",
                 bg="#1e1e1e", fg="#ccc").pack(anchor="w", padx=6, pady=2)
        self.content_type_var = tk.StringVar(value="application/json")
        ttk.Combobox(body_tab, textvariable=self.content_type_var,
                     values=["application/json",
                             "application/x-www-form-urlencoded",
                             "text/plain"], width=28).pack(anchor="w", padx=6)
        tk.Label(body_tab, text="ボディ (JSON):",
                 bg="#1e1e1e", fg="#ccc").pack(anchor="w", padx=6, pady=2)
        self.body_text = tk.Text(body_tab, bg="#0d1117", fg="#c9d1d9",
                                  font=("Courier New", 11), relief=tk.FLAT)
        self.body_text.pack(fill=tk.BOTH, expand=True, padx=6, pady=2)

        # Auth タブ
        auth_tab = tk.Frame(req_notebook, bg="#1e1e1e")
        req_notebook.add(auth_tab, text="認証")
        tk.Label(auth_tab, text="Bearerトークン:",
                 bg="#1e1e1e", fg="#ccc").pack(anchor="w", padx=6, pady=8)
        self.auth_var = tk.StringVar()
        ttk.Entry(auth_tab, textvariable=self.auth_var, width=36).pack(
            anchor="w", padx=6)
        tk.Label(auth_tab, text="Base64ユーザー:パスワード:",
                 bg="#1e1e1e", fg="#ccc").pack(anchor="w", padx=6, pady=(12, 2))
        self.basic_var = tk.StringVar()
        ttk.Entry(auth_tab, textvariable=self.basic_var, width=36).pack(
            anchor="w", padx=6)

        paned.add(left, weight=2)

        # 右: レスポンス
        right = tk.Frame(paned, bg="#1e1e1e")
        # ステータスバー
        self.resp_status_label = tk.Label(right, text="",
                                          bg="#1e1e1e", fg="#3fb950",
                                          font=("Arial", 12, "bold"))
        self.resp_status_label.pack(anchor="w", padx=6, pady=4)

        resp_notebook = ttk.Notebook(right)
        resp_notebook.pack(fill=tk.BOTH, expand=True)

        # ボディ
        body_resp_tab = tk.Frame(resp_notebook, bg="#0d1117")
        resp_notebook.add(body_resp_tab, text="ボディ")
        self.resp_text = tk.Text(body_resp_tab, bg="#0d1117", fg="#c9d1d9",
                                  font=("Courier New", 11), relief=tk.FLAT,
                                  wrap=tk.NONE, state=tk.DISABLED)
        h_sb = ttk.Scrollbar(body_resp_tab, orient=tk.HORIZONTAL,
                             command=self.resp_text.xview)
        v_sb = ttk.Scrollbar(body_resp_tab, orient=tk.VERTICAL,
                             command=self.resp_text.yview)
        self.resp_text.configure(xscrollcommand=h_sb.set,
                                 yscrollcommand=v_sb.set)
        v_sb.pack(side=tk.RIGHT, fill=tk.Y)
        h_sb.pack(side=tk.BOTTOM, fill=tk.X)
        self.resp_text.pack(fill=tk.BOTH, expand=True)

        # ヘッダー
        hdr_tab = tk.Frame(resp_notebook, bg="#0d1117")
        resp_notebook.add(hdr_tab, text="レスポンスヘッダー")
        self.resp_hdr_text = tk.Text(hdr_tab, bg="#0d1117", fg="#c9d1d9",
                                      font=("Courier New", 11), relief=tk.FLAT,
                                      state=tk.DISABLED)
        self.resp_hdr_text.pack(fill=tk.BOTH, expand=True)

        # 履歴タブ
        hist_tab = tk.Frame(resp_notebook, bg="#1e1e1e")
        resp_notebook.add(hist_tab, text="履歴")
        self.hist_listbox = tk.Listbox(hist_tab, bg="#0d1117", fg="#c9d1d9",
                                        font=("Courier New", 10))
        self.hist_listbox.pack(fill=tk.BOTH, expand=True)
        self.hist_listbox.bind("<Double-1>", self._load_history)

        paned.add(right, weight=3)

        self.status_var = tk.StringVar(value="送信待機中")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#252526", fg="#858585", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _build_headers_tab(self, parent):
        tk.Label(parent, text="ヘッダー (Key: Value 形式):",
                 bg="#1e1e1e", fg="#ccc").pack(anchor="w", padx=6, pady=2)
        self.headers_text = tk.Text(parent, bg="#0d1117", fg="#c9d1d9",
                                     font=("Courier New", 11), relief=tk.FLAT,
                                     height=8)
        self.headers_text.pack(fill=tk.BOTH, expand=True, padx=6, pady=4)
        self.headers_text.insert("1.0",
                                  "Accept: application/json\nContent-Type: application/json")

    def _load_sample(self, event):
        name = self.sample_var.get()
        if name in self.SAMPLE_APIS:
            method, url, body = self.SAMPLE_APIS[name]
            self.method_var.set(method)
            self.url_var.set(url)
            self.body_text.delete("1.0", tk.END)
            if body:
                try:
                    formatted = json.dumps(json.loads(body), indent=2,
                                           ensure_ascii=False)
                    self.body_text.insert("1.0", formatted)
                except Exception:
                    self.body_text.insert("1.0", body)

    def _send(self):
        url = self.url_var.get().strip()
        if not url:
            messagebox.showwarning("警告", "URLを入力してください")
            return
        self.send_btn.config(state=tk.DISABLED)
        self.status_var.set("送信中...")
        threading.Thread(target=self._do_send, args=(url,), daemon=True).start()

    def _do_send(self, url):
        method = self.method_var.get()
        body_raw = self.body_text.get("1.0", tk.END).strip()
        headers_raw = self.headers_text.get("1.0", tk.END).strip()
        auth = self.auth_var.get().strip()
        basic = self.basic_var.get().strip()

        headers = {}
        for line in headers_raw.splitlines():
            if ":" in line:
                k, v = line.split(":", 1)
                headers[k.strip()] = v.strip()
        if auth:
            headers["Authorization"] = f"Bearer {auth}"
        if basic:
            import base64
            headers["Authorization"] = "Basic " + base64.b64encode(
                basic.encode()).decode()

        try:
            data = body_raw.encode("utf-8") if body_raw and method != "GET" else None
            req = urllib.request.Request(url, data=data,
                                          headers=headers, method=method)
            import time
            t0 = time.time()
            with urllib.request.urlopen(req, timeout=15) as resp:
                elapsed = (time.time() - t0) * 1000
                status = resp.status
                resp_headers = dict(resp.headers)
                body = resp.read().decode("utf-8", errors="replace")
                self.root.after(0, self._show_response,
                                status, body, resp_headers, elapsed, url, method)
        except urllib.error.HTTPError as e:
            elapsed = 0
            body = e.read().decode("utf-8", errors="replace")
            resp_headers = dict(e.headers) if e.headers else {}
            self.root.after(0, self._show_response,
                            e.code, body, resp_headers, 0, url, method)
        except Exception as e:
            self.root.after(0, self._show_error, str(e))

    def _show_response(self, status, body, resp_headers, elapsed, url, method):
        color = "#3fb950" if 200 <= status < 300 else "#f97583"
        self.resp_status_label.config(
            text=f"● {status}  {elapsed:.0f}ms  {len(body.encode())} B",
            fg=color)
        # ボディ整形
        try:
            parsed = json.loads(body)
            formatted = json.dumps(parsed, indent=2, ensure_ascii=False)
        except Exception:
            formatted = body
        self.resp_text.config(state=tk.NORMAL)
        self.resp_text.delete("1.0", tk.END)
        self.resp_text.insert("1.0", formatted)
        self.resp_text.config(state=tk.DISABLED)
        # ヘッダー
        hdr_str = "\n".join(f"{k}: {v}" for k, v in resp_headers.items())
        self.resp_hdr_text.config(state=tk.NORMAL)
        self.resp_hdr_text.delete("1.0", tk.END)
        self.resp_hdr_text.insert("1.0", hdr_str)
        self.resp_hdr_text.config(state=tk.DISABLED)
        # 履歴
        entry = f"[{datetime.now().strftime('%H:%M:%S')}] {method} {status} {url[:50]}"
        self._history.insert(0, (entry, method, url, body[:500] if body else ""))
        self.hist_listbox.insert(0, entry)

        self.send_btn.config(state=tk.NORMAL)
        self.status_var.set(f"完了: {status}  {elapsed:.0f}ms")

    def _show_error(self, msg):
        self.resp_status_label.config(text=f"● エラー: {msg}", fg="#f97583")
        self.send_btn.config(state=tk.NORMAL)
        self.status_var.set(f"エラー: {msg}")

    def _load_history(self, event):
        sel = self.hist_listbox.curselection()
        if sel and sel[0] < len(self._history):
            _, method, url, body = self._history[sel[0]]
            self.method_var.set(method)
            self.url_var.set(url)
            self.body_text.delete("1.0", tk.END)
            self.body_text.insert("1.0", body)


if __name__ == "__main__":
    root = tk.Tk()
    app = App28(root)
    root.mainloop()

5. コード解説

REST APIテスターのコードを、実際に書かれている実装に沿って解説します。

クラス設計とコンストラクタ

App28 クラスにアプリの全機能をまとめています（メソッド9個・全287行）。__init__ ではタイトル「REST APIテスター」とウィンドウサイズ 960x680 を設定します。最後に _build_ui() で画面を組み立てます。