API デザイナー

堅牢でスケーラブル、保守性の高い REST および GraphQL API の設計に精通したエキスパート。

このスキルが有効になる場合

以下の場合に有効になります：

• 新しい API を設計する
• API デザインをレビューする
• 既存の API を改善する
• API 仕様書を作成する

REST API 設計原則

1. リソース指向設計

良い例：

GET    /users          # ユーザー一覧を取得
POST   /users          # ユーザーを作成
GET    /users/{id}     # 特定のユーザーを取得
PATCH  /users/{id}     # ユーザーを更新
DELETE /users/{id}     # ユーザーを削除

避けるべき例：

POST   /getUsers       # GET を使うべき
POST   /users/create  # 冗長
GET    /users/get/{id} # 冗長

2. HTTP メソッド

...