RAML（RESTful API Modeling Language）

RAML（RESTful API Modeling Language）とは、RESTful APIの設計・文書化を行うためのマークアップ言語である。

概要

金融業界におけるAPI標準化の必要性から生まれたRAMLは、YAMLベースで記述され、リソース構造やデータ型、認証方式などを統一的に表現できる点が特徴だ。オープンバンキングやPSD2対応のためにAPI設計者が共通言語として採用し、国際的な規格化動きと並行して発展した。

役割と機能

RAMLは金融サービスで以下の場面で活用される。
APIバンキング：口座情報や取引履歴を提供するエンドポイントを明確に定義し、銀行間連携を円滑化。
PSD2・Open Banking：認可フロー（OAuth 2.0）やAPIセキュリティ（JWT, TLS）をスキーマで記述し、監査証跡を残す。
KYC/AMLデータ交換：顧客情報の構造と検証ルールを統一化し、コンプライアンスプロセスを自動化。
BaaS・組込型金融：サービス提供者がAPIゲートウェイ経由で機能を組み込みやすくするために、リソースタイプとトレイトを再利用可能なモジュールとして設計できる。

特徴

• YAML構文：人間可読性が高く、ツールチェーン（Swagger UI, RAML2HTML）との連携も容易。
• リソースタイプ・トレイト：共通パターンを抽象化し、API設計の重複作業を削減。
• セキュリティスキーマ統合：OAuth 2.0, OpenID Connect, APIキー等を明示的に記述できる。
• コード生成サポート：クライアント・サーバーのスタブやSDKを自動生成し、実装フェーズでのミスを減少させる。
  これらはOpenAPI（Swagger）と同等または一部優位性を持ち、特に金融業界の規制対応に重きを置いた設計が可能だ。

現在の位置づけ

近年ではOpenAPI 3.x が主流となり、多くのベンダーが移行している。とはいえ、RAMLはそのモジュール性とセキュリティ定義の柔軟性から、PSD2準拠の金融機関やBaaSプロバイダーで依然として採用されている。特に、APIゲートウェイとの統合やコンプライアンス監査を重視する組織では、RAMLベースの仕様が選択肢となるケースが多い。また、規制機関がAPI設計ガイドラインでRAMLを参照する動きも見られ、金融サービス全体における標準化プロセスに貢献している。

bot-trap