ApiFuse Gateway, API Reference, Playground를 실제 공개 범위 기준으로 시작하는 방법입니다.

시작하기

ApiFuse는 현재 공개 registry에 있는 provider operation을 Gateway와 OpenAPI Reference로 제공합니다. 가장 안전한 시작 방법은 API Reference에서 operation을 고르고, 해당 schema대로 POST /v1/{providerId}/{operationId}를 호출하는 것입니다.

현재 문서 정책

문서에는 실제 registry와 코드 경로로 확인 가능한 기능만 남깁니다. Roadmap성 catalog, 미출시 패키지, 구현되지 않은 경로는 공개 가이드에서 제외했습니다.

1. Operation 고르기

API Reference는 provider registry에서 생성됩니다. 문서에 보이는 provider와 operation은 코드에 등록된 항목입니다.

예시:

kma-forecast/short-forecast — 기상청 단기예보
kakaomap-api/search — 카카오맵 장소 검색
delivery-api/track — 택배 배송 조회
law-service/search — 국가법령정보 검색

2. Gateway 호출하기

curl -X POST https://api.apifuse.com/v1/kma-forecast/short-forecast \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"gridX":60,"gridY":127}'

경로 형식: POST /v1/{providerId}/{operationId}
요청 body: 각 operation의 input schema 기준 JSON object
인증: ApiFuse API key가 필요합니다.
connection 필요 operation은 X-ApiFuse-Connection-Id: conn_<22-char> 헤더가 필요할 수 있습니다.

3. 브라우저에서 테스트하기

API Reference에서 provider를 선택합니다.
operation schema와 예시 값을 확인합니다.
Scalar try-it-out 패널에서 platform demo proxy를 통해 호출을 테스트합니다.
자연어 탐색이 필요하면 Playground를 사용합니다. Playground는 /api/playground/chat에서 Gateway MCP 도구를 사용합니다.

Coding agent로 typed integration을 만들 때는 Developer MCP guide에서 operation을 찾고 Schema bundles의 generated artifacts를 가져온 뒤, Next.js 또는 FastAPI처럼 서버 측 코드에서 Gateway를 호출하세요. Gateway MCP의 apifuse_dev_* tool 자체는 provider operation을 실행하지 않습니다.