API開発スキルの学び方｜REST APIの基礎からフリーランス案件獲得まで

バックエンドエンジニアとしてフリーランスで独立して6年になるが、「一番役に立っているスキルは？」と聞かれたら、迷わず「API設計」と答える。

フロントエンドのフレームワークは数年で流行が変わる。ReactかVueか、Next.jsかNuxtか。でもAPIの設計原則は10年以上変わっていない。RESTful APIの考え方を一度マスターすれば、言語やフレームワークが変わっても応用が利く。

前職はSIerで、Java + Spring BootでWebシステムのAPI開発をしていた。独立後はNode.js（Express）を主軸にしつつ、Go、Pythonの案件も受けている。言語が変わっても、API設計の考え方は共通だ。

この記事では、API開発のスキルをゼロから身につけるためのロードマップを解説する。

APIとは何か

API（Application Programming Interface）は、ソフトウェア同士がデータをやり取りするための窓口。

具体例を挙げよう。天気予報アプリを開く → アプリがサーバーに「東京の天気教えて」とリクエストを送る → サーバーが「晴れ、最高気温22℃」とレスポンスを返す → アプリが画面に表示。この「リクエスト → レスポンス」の仕組みがAPI。

フリーランスの案件で「API開発」と言う場合、ほとんどはWeb API（HTTP通信で動くAPI）を指す。中でもREST APIが主流だ。

REST APIの設計原則

REST（Representational State Transfer）は、APIを設計するためのアーキテクチャスタイル。難しく聞こえるが、守るべきルールは明確。

リソース指向

APIのURLは「リソース（データ）」を表す名詞にする。動詞は使わない。

NG	OK
/getUsers	/users
/createJob	/jobs
/deleteUser/123	/users/123

操作の種類は、HTTPメソッドで表現する。

メソッド	意味	例
GET	取得	GET /users → ユーザー一覧取得
POST	作成	POST /users → ユーザー新規作成
PUT	更新（全体）	PUT /users/123 → ユーザー情報を上書き
PATCH	更新（部分）	PATCH /users/123 → 一部フィールドだけ更新
DELETE	削除	DELETE /users/123 → ユーザー削除

ステータスコード

レスポンスには適切なHTTPステータスコードをつける。

コード	意味	使い所
200	OK	正常取得
201	Created	リソース作成成功
400	Bad Request	リクエストの形式が不正
401	Unauthorized	認証が必要
403	Forbidden	権限がない
404	Not Found	リソースが存在しない
500	Internal Server Error	サーバー側のエラー

クライアント側の開発者は、ステータスコードを見てエラーの原因を判断する。適切なステータスコードを返すことは、API開発者の基本的なマナーだ。

レスポンス形式

現在はJSON形式が標準。XMLを指定される案件はほぼない。

{
  "data": {
    "id": 123,
    "name": "田中太郎",
    "email": "[email protected]"
  },
  "meta": {
    "timestamp": "2026-03-27T10:00:00Z"
  }
}

エラーレスポンスも統一されたフォーマットで返す。

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "メールアドレスの形式が不正です",
    "field": "email"
  }
}

学習ロードマップ

Phase 1：HTTPの基礎（1週間）

APIを作る前に、HTTP通信の仕組みを理解する。

• HTTPリクエストの構造（メソッド、URL、ヘッダー、ボディ）
• HTTPレスポンスの構造（ステータスコード、ヘッダー、ボディ）
• クッキーとセッション
• CORS（クロスオリジン・リソース・シェアリング）

Postmanというツールを使うと、ブラウザを使わずにAPIにリクエストを送れる。公開APIで練習するのがおすすめ。たとえばJSONPlaceholder（jsonplaceholder.typicode.com）は無料で使えるダミーAPI。

Phase 2：フレームワークの選定と実装（2〜4週間）

実際にAPIを構築する。言語とフレームワークの選定が最初のポイント。

言語	フレームワーク	特徴	案件数
JavaScript/TypeScript	Express / Fastify	学習コスト低、フルスタック案件に強い	非常に多い
Python	FastAPI / Django REST	データ分析・AI連携が得意	多い
Go	Gin / Echo	高パフォーマンス、マイクロサービス向き	増加中
Java	Spring Boot	エンタープライズ、大規模案件	安定的

フリーランスの案件数を考えると、Node.js（Express/Fastify）かPython（FastAPI）から始めるのが効率的。どちらも学習リソースが豊富で、実装もシンプル。

自分の場合、Express.jsで最初のAPIを作ったのが独学開始から3週間目。ユーザーのCRUD（作成・読み取り・更新・削除）操作ができるシンプルなAPIだったが、「自分で作ったAPIが動いた」という感動は今でも覚えている。

Phase 3：データベース連携（2〜3週間）

APIは単体では意味がない。データベースと連携して初めて実用的なサービスになる。

• リレーショナルデータベース（PostgreSQL、MySQL）との接続
• ORM（Object-Relational Mapping）の使い方
• マイグレーション（テーブル構造の変更管理）
• N+1問題の理解と対策

ORMを使うか、生のSQLを書くかは宗教戦争レベルの議論がある。個人的には「ORMをメインに使いつつ、パフォーマンスが必要な箇所は生SQLで書く」という使い分けを推奨する。

Phase 4：認証と認可（2〜3週間）

セキュリティに関わる重要なフェーズ。

認証（Authentication）: 「あなたは誰？」を確認する仕組み。

• セッションベース認証
• JWT（JSON Web Token）認証
• OAuth 2.0 / OpenID Connect

認可（Authorization）: 「あなたはこの操作をしていい？」を判断する仕組み。

• ロールベースアクセス制御（RBAC）
• リソースベースアクセス制御

認証の実装を間違えると、セキュリティ事故に直結する。「自前で暗号化処理を書く」のは絶対にNG。bcryptやargon2のような検証済みのライブラリを使うこと。

Phase 5：テストとドキュメント（2週間）

テストのないAPIは信頼できない。

テストの種類:

• ユニットテスト: サービス層のロジックを個別にテスト
• 統合テスト: APIエンドポイントにリクエストを送って、正しいレスポンスが返るか確認
• 負荷テスト: 大量のリクエストを同時に送って、パフォーマンスを測定

テストカバレッジは最低でも70%以上を目標にする。

APIドキュメント: Swagger（OpenAPI）を使って、APIの仕様書を自動生成する。ドキュメントがしっかりしているAPIは、フロントエンドエンジニアからの評価が高い。

Phase 6：運用スキル（継続学習）

本番環境で安定してAPIを動かすためのスキル。

• エラーハンドリングとログ管理
• レート制限（DoS攻撃対策）
• キャッシュ戦略（Redis、CDN）
• モニタリング（レスポンスタイム、エラー率の監視）
• CI/CDパイプラインの構築

実務で差がつくAPI設計テクニック

ページネーション

一覧取得APIで全件返すと、データ量が多いときにパフォーマンスが劣化する。ページネーション（ページ分割）は必須。

カーソルベース（?cursor=xxx&limit=20）とオフセットベース（?page=1&limit=20）の2種類がある。大量データにはカーソルベースが有利。

バージョニング

APIの仕様を変更するとき、既存のクライアントを壊さないようにバージョン管理する。

/api/v1/users
/api/v2/users

URLにバージョンを含める方法が最もシンプルで広く使われている。

エラーハンドリングの統一

すべてのエンドポイントで一貫したエラーフォーマットを返すことが重要。エラーコード、メッセージ、必要に応じてフィールド情報を含める。

フリーランスとしてAPI開発案件を獲得する

API開発の案件は高単価が多い。バックエンドの設計ができるエンジニアは常に不足しているからだ。

@SOHOの年収データベースによると、バックエンドエンジニアのフリーランス年収は、API設計やDB設計の経験が豊富なエンジニアほど高い傾向にある。REST APIの設計経験に加えて、認証やパフォーマンスチューニングまで対応できるエンジニアは特に需要が高い。

ポートフォリオの作り方

API開発のポートフォリオは、見た目ではなく「設計の質」で勝負する。

• SwaggerのAPIドキュメント
• テストコードのカバレッジレポート
• アーキテクチャ図（コンポーネントの関係性）
• パフォーマンス計測結果

GitHubにリポジトリを公開して、READMEに上記を記載する。「コードを書けます」ではなく「設計ができます」をアピールすることが大事。

単価の目安

スキルレベル	月単価
REST API実装のみ	40〜55万円
設計 + 実装	55〜75万円
設計 + 実装 + インフラ	75〜100万円
アーキテクト	100万円〜

@SOHOなら手数料0%なので、この金額がそのまま手取りになる。他のプラットフォームでは10〜20%引かれることを考えると、年間で数十万円の差が出る。

@SOHOでバックエンドエンジニアの案件を探そう

API開発スキルは、バックエンドエンジニアの根幹を成す技術だ。フロントエンドのトレンドが変わっても、APIの設計原則は変わらない。一度身につければ、長く使える資産になる。

@SOHOでは手数料0%でバックエンド・API開発の案件が掲載されている。基礎を固めたら、実案件でスキルを磨いていこう。