AI 原生开放教材

外观

VibeFast 文档官方文档·英文原文 ↗原件 ↓仓库 ↗

APIとは何か？フロントエンドとバックエンドの通信をわかりやすく解説 ​

English · 繁中 · Español · 日本語 · Português (BR)

著者： Danko Peng（@dankopeng）
更新： 2026年3月
読了時間： 約7分

毎日使っている身近な例え ​

あなたがレストランで食事をする場面を想像してほしい。

自分でキッチンに入って料理するのではなく、ウェイターに何が食べたいかを伝える。ウェイターはあなたの注文をキッチンに届け、料理ができたらウェイターが料理を運んでくる。

ウェイターがAPIだ。

APIはフロントエンド（あなた）とバックエンド（キッチン）の間をつなぐ橋だ。フロントエンドはバックエンドがどう動いているかを知る必要はなく、APIとのやりとり方さえわかればいい。

APIとは何か？ ​

API（Application Programming Interface） は2つのシステム間の通信方法を定義した規則の集まりだ。

Webアプリの文脈では通常：

  • フロントエンド（ブラウザのページ）がリクエストを送る
  • バックエンドAPI（サーバー）がリクエストを受け取り、処理して、結果を返す

典型的なAPIリクエストはこんな形だ：

フロントエンドが聞く：「userId = 123 のユーザーデータをください」
→ GET /api/users/123

バックエンドが答える：「了解、これがそのデータです」
→ { "id": 123, "name": "Danko", "email": "danko@example.com" }

HTTPメソッド：APIに何を伝えているのか？ ​

APIリクエストには4種類の一般的な操作があり、それぞれ異なるHTTPメソッドに対応している：

メソッド用途例え
GETデータを読む「メニューを見せて」
POSTデータを追加「これを注文したい」
PUT / PATCHデータを更新「別の料理に変えたい」
DELETEデータを削除「この注文をキャンセル」

APIレスポンス：バックエンドは何を返すのか？ ​

バックエンドのレスポンスは通常2つの部分を含む：

HTTPステータスコード——数字で結果を伝える：

ステータスコード意味
200成功
201作成成功
400リクエストに問題がある（Bad Request）
401ログインしていない（Unauthorized）
403権限がない（Forbidden）
404見つからない（Not Found）
500サーバーエラー（Server Error）

レスポンスの内容——通常はJSON形式：

json
{
  "success": true,
  "data": {
    "id": 123,
    "name": "Danko"
  }
}

vibefast.appのAPIアーキテクチャ ​

vibefast.appは Service Binding を使ってフロントエンドとバックエンドをCloudflare内部で直接通信させ、公開ネットワークを経由しない。

ブラウザ
  ↓ HTTPリクエスト
Remix フロントエンドWorker
  ↓ Service Binding（内部、CORSゼロ）
Workers API
  ↓
D1 データベース

これが意味すること：

  • バックエンドAPIに公開URLがなく、外部から直接アクセスできない
  • フロントエンドとバックエンド間でCORSの設定が不要
  • APIの呼び出しごとにネットワークの往復が1回減り、速くなる

サードパーティAPI：あなたのアプリも他のAPIを呼んでいる ​

あなたのアプリには独自のAPIだけでなく、他のAPIへの呼び出しも含まれる：

  • Stripe API：「この支払いを処理して」
  • Resend API：「このユーザーにメールを送って」
  • Cloudflare API：npm run deploy の裏ではCloudflare APIが呼ばれている

これらのサードパーティAPIを使うにはAPIキーが必要だ——だから前の記事でAPIキーは環境変数に安全に保管すると説明した。

AIでAPIエンドポイントを設計する ​

これがVibe Codingの実際の応用シーンだ。AIに直接伝えるだけでいい：

「Cloudflare Workersに GET /api/posts エンドポイントを作ってください。公開済みの記事をすべて返し、作成日時の降順で並べ替え、1ページ10件にしてください。」

AIはこのようなコードを生成する：

typescript
// apps/api/src/routes/posts.ts
app.get("/api/posts", async (c) => {
  const page = Number(c.req.query("page") || 1)
  const limit = 10
  const offset = (page - 1) * limit

  const posts = await c.env.DB.prepare(`
    SELECT id, title, slug, created_at 
    FROM posts 
    WHERE status = 'published'
    ORDER BY created_at DESC
    LIMIT ? OFFSET ?
  `).bind(limit, offset).all()

  return c.json({ success: true, data: posts.results })
})

自分でこれを書く必要はないが、何をしているかを読めることで、AIの出力が正しいかどうかをより良く判断できる。

Danko Peng
X · YouTube · Threads

👉 チュートリアルトップに戻る

完全なCloudflareフルスタックテンプレートを今すぐ使い始めたい方へ：
👉 vibefast.app — アーリーバード $99、2026年8月1日より $199 に値上がり。