APIFuse 게이트웨이, API 레퍼런스, 플레이그라운드 사용을 처음부터 안내합니다.

시작하기

APIFuse는 다양한 외부 API를 게이트웨이와 OpenAPI 레퍼런스로 제공합니다. 가장 빠르게 시작하는 방법은 API 레퍼런스에서 operation을 고르고, 해당 스키마대로 POST /v1/{providerId}/{operationId}를 호출하는 것입니다.

1. operation 고르기

API 레퍼런스에서 사용할 provider와 operation을 선택합니다.

예시:

korea-weather/short-forecast — 기상청 단기예보
kakaomap/search — 카카오맵 장소 검색
korea-parcel-tracking/track — 택배 배송 조회
korea-national-law/search-legal-resources — 국가법령정보 통합 검색

2. 게이트웨이 호출하기

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

경로 형식: POST /v1/{providerId}/{operationId}
요청 본문: 각 operation의 입력 스키마에 맞는 JSON 객체
인증: APIFuse API 키가 필요합니다.
connection이 필요한 operation은 X-ApiFuse-Connection-Id: af_con_<22-char> 헤더를 추가해야 합니다.

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

API 레퍼런스에서 provider를 선택합니다.
operation 스키마와 예시 값을 확인합니다.
API 레퍼런스의 직접 호출 패널에서 호출을 테스트합니다.
자연어로 탐색하고 싶다면 플레이그라운드를 사용합니다.

코딩 에이전트로 타입 안전한 연동을 만들 때는 개발자 MCP 가이드에서 operation을 찾고, 스키마 번들의 생성된 아티팩트를 가져온 뒤, Next.js 또는 FastAPI 가이드를 참고하여 서버 측 코드에서 게이트웨이를 호출하세요. apifuse_dev_* 도구는 탐색·스키마·가이드 용도이고, 실제 operation 호출은 서버 측 게이트웨이에서 수행합니다.