Open API Initiativeが提案する新たなAPIワークフロー定義「Arazzo Specification」 by hkws

PHPerKaigi 2025
ポスターセッション

Open API Initiativeが提案する新たなAPIワークフロー定義「Arazzo Specification」

__tortoise hkws __tortoise
1

WebAPIを介して他のサービスと連携して、新しいサービスを作ることってありますよね。Googleアカウントでログインする機能の実装はまさにその一例です。
しかし、OpenAPI Specification等のフォーマットで各APIの仕様が公開されていたとしても、それらをどう組み合わせれば目的のユースケースを実現できるかは自明ではありません。ドキュメントを読み込み試行錯誤する中で、API間の依存関係やシーケンスを解き明かした経験がある方も多いのではないでしょうか。
この問題を解決するために、OpenAPI Initiativeでは「Arazzo Specification」という新しいAPIワークフロー定義が検討されています。2024年5月には、この仕様のv1.0.0が公開されました。本ポスターでは、そんな「Arazzo Specification」の詳細について解説します。

【予定している内容】

  • Arazzo Specificationの概要
  • 想定されるユースケース
  • Arazzo Specificationの詳細内容
  • Arazzoを用いたAPIワークフローの記述例