enterprise-integration-api-developer

エンタープライズ統合 API 開発者

使用する場合

• エンタープライズ統合プラットフォーム（ハブ、メッシュ隣接サービス、ハイブリッド iPaaS パターン）を設計する
• バージョニング、ページネーション、フィルタリング、エラー契約を備えた REST または GraphQL API を仕様化する
• OpenAPI または AsyncAPI 仕様と、コンシューマー主導の契約テストを作成する
• イベント駆動型のフロー（トピック／キュー、アウトボックス、冪等なコンシューマー、補償アクション）を実装する
• 境界づけられたコンテキスト間の 正規モデル、マッピング、腐敗防止層を定義する
• API ゲートウェイ、B2B パートナーエンドポイント、Webhook、変換／ルーティングルールを構築する
• 内部および外部の呼び出し元向けに OAuth2/OIDC、API キー、mTLS、スコープモデルを適用する
• 相関 ID、トレース伝播、構造化エラー、DLQ 運用などの オブザーバビリティを計画する
• 廃止ヘッダー、サンセットポリシー、後方互換性のあるスキーマ進化などの ライフサイクルを管理する

使用しない場合

• X12/EDIFACT セグメントマッピング、997/APERAK、AS2/VAN EDI トランスポート → edi-engineer
• 機密環境のエアギャップビルド、ATO 証跡、認可済みパイプラインでのプロモーションのみ → classified-software-devsecops-engineer
• VRP、MIP、スケジューリング、またはソルバーベースの最適化 → operations-research-algorithm-developer
• 統合アーキテクチャを伴わない一般的なアプリケーションの CRUD、UI、単一サービスの機能 → senior-software-engineer
• CI/CD パイプラインの YAML、GitOps、デプロイの仕組みのみ → devops
• ランディングゾーン、VPC、マネージドクラウドリソースの設計 → cloud-engineer
• エンタープライズ全体のクラウド参照アーキテクチャと移行ロードマップ → cloud-architect
• 内部開発者プラットフォームのゴールデンパスとポータル → platform-engineer

関連スキル

必要な内容	スキル
EDI 標準、セグメント、パートナー認証	edi-engineer
アプリケーションサービスとコード品質	senior-software-engineer
CI/CD、GitOps、統合サービスのデプロイ	devops
統合向けクラウドメッセージング、ネットワーキング、IAM	cloud-engineer
クラウド参照アーキテクチャとランディングゾーン	cloud-architect
IDP、ゴールデンパス、整備済みテンプレート	platform-engineer
機密環境の DevSecOps とプロモーション境界	classified-software-devsecops-engineer
OR モデル、ルーティング、割り当てソルバー	operations-research-algorithm-developer
エンタープライズアーキテクチャの ADR とシステム横断レビュー	senior-system-architecture
パイプラインセキュリティとサプライチェーン	devsecops

主なワークフロー

1. スコープと統合境界

信頼できる唯一の情報源となるシステム、同期と非同期の境界、パートナー向けと内部向けのインターフェース、対象外事項を定義します。

references/enterprise_integration_api_scope.mdを参照してください。

2. API 設計と契約

リソース、エラー、バージョニングをモデル化し、契約テストとともに OpenAPI/AsyncAPI を公開します。

references/api_design_and_contracts.mdを参照してください。

3. イベント駆動型の信頼性

メッセージングパターン、冪等性キー、アウトボックス、サーガ／コレオグラフィ、障害処理を選定します。

references/event_driven_and_reliability.mdを参照してください。

4. 正規モデルと変換

正規スキーマ、ACL、マッピングルール、受信時／送信時の検証を定義します。

references/canonical_models_and_transformations.mdを参照してください。

5. セキュリティ、ゲートウェイ、ガバナンス

ゲートウェイ、認証、レート制限、パートナーのオンボーディング、ポリシーの適用を設定します。

references/security_governance_and_gateways.mdを参照してください。

6. 運用、オブザーバビリティ、ライフサイクル

トレースとメトリクスを計装し、DLQ を運用して、廃止および互換性計画を実行します。

references/operations_observability_and_lifecycle.mdを参照してください。

成果物

• 統合コンテキスト図 — システム、チャネル、同期／非同期、信頼ゾーン
• コントラクト関連成果物 — OpenAPI／AsyncAPI、JSON Schema、ペイロード例、エラーカタログ
• マッピング仕様 — 正規フィールド、変換、検証ルール、冪等性戦略
• ランブック — 再生、DLQ の排出、パートナーの切り替え、ロールバック、互換性マトリックス
• ADR または意思決定ログ — オーケストレーションとコレオグラフィーの比較、バージョニング、認証モデル

原則

• 暗黙知よりもコントラクトとスキーマを優先し、CI でコンシューマーをテストします
• 外部との各境界で、冪等性と重複排除を明確にします
• パートナー（B2B）向けの領域と内部メッシュのトラフィックを分離します。認証、SLO、変更可能期間が異なるためです
• 障害を可観測にする設計にします。エンドツーエンドの相関 ID、構造化エラー、対応可能な DLQ を用意します
• 後方互換性のある変更をリリースします。廃止時期を文書化し、コンシューマーに移行期間を設けます