OpenAPI와 스키마 아티팩트
APIFuse OpenAPI 3.1 문서와 개발자 스키마 번들을 사용하는 방법입니다.
OpenAPI 3.1과 스키마 아티팩트
APIFuse는 API 레퍼런스, OpenAPI 3.1 문서, 코딩 에이전트용 스키마 번들을 모두 같은 데이터 소스에서 제공합니다. 어디서 보든 동일한 입출력 스키마, 인증 요구사항, 예시를 확인할 수 있습니다.
엔드포인트
| 위치 | 설명 |
|---|---|
/providers | provider와 operation 둘러보기 |
/providers/{providerId} | 단일 provider의 개요와 기능 |
/docs/api/{providerId} | 단일 provider의 API 레퍼런스 |
/api/openapi.json | 전체 OpenAPI 3.1 JSON |
https://api.apifuse.com/mcp | MCP 엔드포인트; operation 조회/실행 런타임 도구와 apifuse_dev_* 스키마 도구 |
게이트웨이 경로 형식
모든 provider operation은 다음 형식으로 호출합니다. API 레퍼런스의 직접 호출 테스트도 같은 경로를 사용합니다.
POST /v1/{providerId}/{operationId}예시:
POST /v1/korea-weather/short-forecast
POST /v1/korea-national-law/search-legal-resources스키마 번들 구성
operation 스키마 번들에는 다음 정보가 포함됩니다.
- 입출력 JSON Schema
- OpenAPI operation 조각
- TypeScript 입출력 타입
- Zod 입출력 스키마
- Pydantic v2 입출력 모델
- 요청·응답 예시
- 인증 모드와 인가 요구사항
- 스키마, 대상 아티팩트, 번들 해시
- 손실 변환 경고