ApiFuse API Docs
실제 provider registry에서 생성되는 ApiFuse API Reference와 Playground 안내입니다.
ApiFuse API Docs
ApiFuse는 provider registry에 등록된 API operation을 단일 Gateway 경로와 표준 OpenAPI 문서로 제공합니다. 현재 공개 문서와 API Reference는 Gateway Provider Metadata API가 제공하는 공개 provider/operation 메타데이터만 노출합니다.
문서 노출 기준
이 문서에서는 실제 registry, Gateway, Playground, MCP endpoint로 확인 가능한 기능만 안내합니다. 아직 registry에 없거나 운영 확신이 부족한 API·기능은 공개 문서와 catalog에서 제외합니다.
빠른 시작
API Reference에서 operation을 선택한 뒤, Gateway에 POST /v1/{providerId}/{operationId} 형식으로 호출합니다.
curl -X POST https://api.apifuse.com/v1/kma-forecast/short-forecast \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"baseDate":"20260513","baseTime":"0500","gridX":60,"gridY":127}'자연어 탐색이 필요하면 platform의 Prompt Playground를 사용하세요. Playground는 /api/playground/chat에서 Gateway MCP 도구를 사용합니다.
현재 제공 범위
- Provider Metadata API 기반 API Reference — Gateway가 로드한 signed metadata projection에서 공개 provider/operation만 표시합니다.
- Gateway 호출 — 모든 operation은
POST /v1/{providerId}/{operationId}경로를 사용합니다. - OpenAPI 3.1 —
/docs/api와/api/openapi.json에서 registry 기반 스키마를 확인할 수 있습니다. - Playground — platform proxy가 demo key를 서버에서 주입해 Prompt Playground와 operation try-it-out을 제공합니다.
- Hosted MCP endpoint — Platform
/api/mcp가 Gateway/mcp를 proxy합니다. 같은 metadata projection이 runtime router tool과apifuse_dev_*read-only schema 도구를 노출합니다.
현재 지원 provider 예시
| Provider | 예시 operation | Gateway path |
|---|---|---|
| 기상청 예보 데이터 | 단기예보, 중기예보 | POST /v1/kma-forecast/short-forecast |
| 카카오맵 장소 검색 및 길찾기 | 장소 검색, 지오코딩, 길찾기 | POST /v1/kakaomap-api/search |
| 국가법령정보 검색 및 조회 | 법령 검색, 상세 조회 | POST /v1/law-service/search |
| 네이버 지도 API | 검색, 지오코딩, 인증 필요 저장 목록 | POST /v1/naver-map-api/search |
전체 목록은 API Reference에서 확인하세요.
응답 형식
Provider SDK operation은 operation별 output schema를 반환하고, Gateway/문서 레이어는 operation metadata와 에러 envelope을 함께 다룹니다. 정확한 request/response schema는 항상 API Reference의 각 operation 스키마를 기준으로 확인하세요.
{
"observedAt": "2026-05-13T14:00:00+09:00",
"grid": { "x": 60, "y": 127 },
"temperature": 18.4
}다음 단계
- API Reference — provider별 operation, 파라미터, response schema, try-it-out 확인
- 시작하기 — Gateway 호출과 Playground 사용 흐름 확인
- Developer MCP guide — coding agent용 read-only schema/artifact workflow 확인
- Schema bundles — bundle hash, target artifact hash, conversion warning 의미 확인
- Next.js App Router / FastAPI — server-side integration 예시 확인
- Artifact observability — artifact/MCP route 진단과 release checks 확인
- Playground — Prompt Playground와 operation try-it-out 범위 확인