이 저장소는 ** 모든 공개 Anypoint Platform API 사양에 대한 진실의 단일 소스입니다. 그것은 모든 생산 접근 가능한 API를 위한 OpenAPI (OAS) 명세를 포함합니다.

목적

• 모든 공개 Anypoint 플랫폼 API의 중앙화된 레지스트리
• API 사양을 보장하고 AI-agent-friendly 표준 준수
• 표준화, 잘 문서화 된 specs를 통해 API 발견 및 소비 활성화
• API 사양에 대한 버전 제어 및 변경 추적 제공

저장소 구조

각 API 서비스는 다음과 같은 자체 디렉토리가 있습니다.

저장소에는 공유 툴링이 포함됩니다.

시작하기

# 필수품

• Node.js 및 npm 설치 ( Anypoint CLI용)
• API 프로젝트 플러그인을 가진 Anypoint CLI v4
• Python 3 (포털 생성기 및 검증 스크립트용)
• Claude Code CLI (인증 기술용)

필요한 도구 설치

1. Anypoint CLI v4 설치:

2. Python 의존성 설치:

홈 양조장 관리 파이썬 (macOS)을 사용? Homebrew’s Python은 “externally-managed” 환경 (PEP 668)로 표시되어 있으므로 베어 pip3 install는 쓸 수 없습니다.

Anypoint API Specifications

This repository is the single source of truth for all public Anypoint Platform API specifications. It contains OpenAPI (OAS) specifications for all production-accessible APIs.

Purpose

• Centralized registry of all public Anypoint Platform APIs
• Ensures API specifications are validated and compliant with AI-agent-friendly standards
• Enables API discovery and consumption through standardized, well-documented specs
• Provides version control and change tracking for API specifications

Repository Structure

Each API service has its own directory containing:

/
├── api.yaml           # Main OpenAPI specification file
├── exchange.json      # Exchange metadata (groupId, assetId, version, etc.)
├── schemas/           # Reusable schema definitions (optional)
├── examples/          # Request/response examples (optional)
└── skills/            # JTBD workflow skills (optional)

The repository also includes shared tooling:

scripts/
├── portal_generator/  # Static API documentation portal generator
├── tests/             # Portal generator test suite (pytest)
├── generate_portal.py # Entry point for portal generation
├── requirements.txt   # Python dependencies
└── pyproject.toml     # Pytest configuration

Getting Started

Prerequisites

• Node.js and npm installed (for Anypoint CLI)
• Anypoint CLI v4 with API Project plugin
• Python 3 (for portal generator and validation scripts)
• Claude Code CLI (for validation skills)

Installing Required Tools

1. Install Anypoint CLI v4:

npm install -g anypoint-cli-v4
anypoint-cli-v4 plugins:install anypoint-cli-api-project-plugin

2. Install Python dependencies:

pip3 install -r scripts/requirements.txt

Using a Homebrew-managed Python (macOS)? Homebrew’s Python is marked as an “externally-managed” environment (PEP 668), so a bare pip3 install will refuse to write into it. Use a local virtual environment instead (see Generating the Portal with Homebrew-managed Python below).

3. Install API Spec Validation Skills:

# In Claude Code CLI
/plugin marketplace add machaval/api-spec-skills

This installs the api-spec-validator skill which validates specs against AI-agent-friendly best practices using Anypoint CLI under the hood.

4. Git hooks (automatic):

Git hooks are automatically configured the first time you run any make command. Pre-commit runs fast validators (~2-5s) and pre-push runs tests + governed validation. See make help for skip options.

Makefile Commands

The Makefile provides convenient shortcuts for common tasks:

make help                  # Show all available targets
make validate-all-governed # Validate all APIs with governance rules
make validate-api API=name # Validate a specific API
make list-apis             # List all discovered APIs