概要

JSON Schema コース

この実践的 JSON Schema コースで学ぶ内容を紹介します。

JSON Schema はサンプル JSON を、ソフトウェアが検証できる データ契約 に変えます。チームが API payload、設定ファイル、生成データ、fixture、イベントメッセージをサービス間で予測可能に保つ必要があるときに有用です。

このコースでは、開発者が最もよく遭遇する実践的な語彙に焦点を当てます。オブジェクト型、プロパティ、必須フィールド、配列、列挙、形式、ドラフトバージョンです。

対象者

  • JSON payload をやり取りするバックエンドおよびフロントエンド開発者
  • 実際のミスを捕捉するスキーマが欲しい API レビュアー
  • 機械可読な検証契約が必要なツールビルダー
  • fixture と設定ファイルを保守する QA およびプラットフォームチーム

学ぶこと

  1. JSON Schema が何を検証し、単独では何を検証できないか
  2. オブジェクトプロパティ、ネストオブジェクト、必須フィールドのモデル化方法
  3. 配列、列挙、形式が一般的な制約をどう表現するか
  4. ドラフトバージョンと互換性が長寿命スキーマにどう影響するか

読みながら例をローカルで試すには、関連する JSON Schema ジェネレーター を使ってください。