API開発シリーズ①CLIN開発日記 #014｜Staff API完成。スタッフ管理の基盤を構築しました
Staff APIを実装しました
こんにちは。
清掃業務プラットフォーム「CLIN」の開発を進めています。
今回はAPI開発シリーズとして、スタッフ管理の基盤となるStaff APIを実装しました。
今後、スタッフ画面や管理者画面、リアルタイム更新機能など、多くの機能がこのAPIを利用することになります。
今回実装した機能
今回追加したエンドポイントはこちらです。
GET /api/staff
GET /api/staff/:id取得できる情報は、
- スタッフID
- 氏名
- ステータス
- 登録日時
です。
REST APIとしてシンプルな構成ですが、今後の機能追加を見据えた土台になっています。
エラーハンドリングも実装
正常系だけではなく、
存在しないスタッフID
404 Not Foundや、
数値以外のID
400 Bad Requestも実装しました。
開発初期の段階から異常系まで確認することで、安定したAPIを目指しています。
品質を重視したSprint開発
CLINでは現在、
Sprint方式で開発を進めています。
今回も
設計
↓
実装
↓
Build
↓
API動作確認
↓
Git Commitという流れで進めました。
機能を追加するだけではなく、品質を維持しながら開発を積み重ねています。
今後の予定
次のSprintでは、
スタッフ情報をさらに拡張し、
- 今日の担当件数
- 次の作業予定
- 作業中ステータス
- リアルタイム更新
など、現場管理に必要な情報を追加していく予定です。
スタッフ画面と管理者画面をつなぐ中心となるAPIへ育てていきます。
まとめ
Staff APIは画面には見えない機能ですが、CLIN全体を支える重要な基盤です。
今後も一つひとつの機能を積み重ねながら、現場で本当に使いやすい清掃業務プラットフォームを目指して開発を続けていきます。