API例と厳格パイプラインのためにYAMLをJSONに変換する
該当する場合
素早くYAMLで書くが利用側はJSONリテラル期待:変換で型問題と重複キーが露呈。
使うツール
YAMLをJSONに変換。
YAMLをJSONに を開く →手順
- 1重複YAMLキーを探す(最後が静かに勝つことが多い)。
- 2変換しスキーマやOpenAPI例で検証。
- 3数値に見える文字列を文字列のままにすべきか確認。
- 4監査用にソースYAML横にJSON抜粋を版管理。
例
- READMEブロックをSDKテスト用JSONに。
- 編集YAMLからだけJSON上書きを受け付けるビルド。
避けること
- JSONが表現できないYAMLマージキー。
- 変換後のタイムゾーン/ISO-8601期待の見落とし。
- 言語ごとに異なる科学記数法解釈。
関連ツール
ブログで
開発者・データツール のその他
- JSON APIペイロードを素早くデバッグする
- APIと連携向けにCSVをJSONへ変換する
- YAMLとJSONの設定を正規化する
- URLクエリパラメータをテストして修正する
- JWTトークンを安全にデコードして確認する
- 実データサンプルで正規表現をテストする
すべてのタスクガイド または次の 開発者・データツール ハブ.
よくある質問
コメント?
JSONは削除。注釈付きYAMLをgitに残す。
nullと空文字?
両方監査。移行はここでよく失敗。