Guide
인증과 connection
ApiFuse registry의 실제 auth mode와 connection 필요 여부를 설명합니다.
인증과 connection
ApiFuse 문서에서는 과거의 L0/L1/L2 마케팅 분류 대신, provider registry의 실제 auth mode를 기준으로 설명합니다.
현재 공개 registry에는 none operation과 credentials 기반 connection operation이 있습니다.
핵심
API Reference에 표시되는 operation은 registry에서 생성됩니다. connection이 필요한 operation은 호출 전에 tenant-scoped connection(conn_<22-char>)을 준비해야 합니다.
현재 auth mode
| Auth mode | 사용자 준비 사항 | 현재 예시 |
|---|---|---|
none | ApiFuse API key만 필요 | 기상청, 카카오맵 public operation, 법령정보 등 |
credentials | ApiFuse API key + connection ID 필요 | CatchTable, Triple, 네이버 지도 저장 목록/인증 필요 operation 등 |
none operation 호출
curl -X POST https://api.apifuse.com/v1/kakaomap-api/search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"서울역"}'Connection 필요 operation 호출
Connection 필요 operation은 Gateway 호출 시 connection header를 함께 보냅니다.
curl -X POST https://api.apifuse.com/v1/naver-map-api/collections \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-ApiFuse-Connection-Id: conn_1234567890123456789012" \
-H "Content-Type: application/json" \
-d '{}'Connection 생성과 credential ceremony는 Gateway의 /connections와 provider auth.flow를 통해 처리됩니다. 현재 문서에서는 API Reference와 Playground에서 확인 가능한 호출 범위만 안내합니다.