Guide
Playground
ApiFuse Platform의 Prompt Playground와 API Reference try-it-out 범위를 설명합니다.
Playground
ApiFuse Platform에는 두 가지 테스트 경로가 있습니다.
- Prompt Playground — Platform AI SDK가 Gateway MCP 도구를 사용해 provider operation을 호출합니다.
- API Reference try-it-out — 특정 operation을 Platform docs adapter가 Gateway로 전달합니다.
현재 노출 기준
Playground와 API Reference는 registry에 등록된 공개 provider/operation을 기준으로 안내합니다. 미등록 API나 검증되지 않은 catalog 항목은 노출하지 않습니다.
Prompt Playground
Prompt Playground는 브라우저에서 자연어 query를 입력하고 Gateway MCP endpoint를 통해 사용 가능한 provider operation을 실행하는 UI입니다.
- Client →
/api/playground/chat - Platform agent runtime → Gateway
/mcp - Gateway MCP → provider operation executor
API Reference try-it-out
API Reference의 Scalar UI는 provider별 schema와 예시를 공식 Gateway와 같은 /v1/{providerId}/{operationId} 경로 형태로 보여줍니다. Browser 호출은 Platform docs adapter 서버 경로를 통과하며, signed-in 사용자에게는 30초 수명의 Gateway delegation token을 발급해 전달합니다.
- Docs UI server:
/docs/api/{providerId} - Docs adapter server:
/api/proxy/call/v1/{providerId}/{operationId} - Gateway target:
/v1/{providerId}/{operationId}
직접 연동 시 주의
Production client에서는 platform proxy가 아니라 Gateway를 직접 호출하세요.
curl -X POST https://api.apifuse.com/v1/kma-forecast/mid-forecast \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"regionId":"11B10101","tmFc":"202605130600"}'