atsukg https://blog.hatena.ne.jp/atsukg/ WHITEPLUS TechBlog https://blog.wh-plus.co.jp/ こんにちは！コアシステム開発Gでテックリードをやっている古賀です。 APIを改修しようとすると、「どのようなリクエストを送るべきか？」「レスポンスはどのような形式か？」といった疑問に直面することは少なくありません。 コードを読まなければ分からなかったり、ドキュメントがあるものの埋もれていたりすると、そのたびに調査が必要になり生産性を下げてしまいます。 これを防ぐには、API仕様を事前に定義し、誰でも簡単に参照できるようにしておくことが有効です。 APIスキーマを定義する手段としては、gRPCのProtocol Buffersや、GraphQLのスキーマ定義言語など、目的に応じていくつかの方法が… 190 <iframe src="https://hatenablog-parts.com/embed?url=https%3A%2F%2Fblog.wh-plus.co.jp%2Fentry%2F2025%2F06%2F26%2F050000" title="OpenAPI Specification で API スキーマを定義する - WHITEPLUS TechBlog" class="embed-card embed-blogcard" scrolling="no" frameborder="0" style="display: block; width: 100%; height: 190px; max-width: 500px; margin: 10px 0px;"></iframe> https://cdn.user.blog.st-hatena.com/default_entry_og_image/88687625/1571302008852024 Hatena Blog https://hatena.blog 2025-06-26 05:00:00 rich https://blog.wh-plus.co.jp/entry/2025/06/26/050000 1.0 100%