인증과 connection
APIFuse operation의 인증 모드와 connection 필요 여부를 설명합니다.
인증과 connection
APIFuse operation은 두 가지 인증 모드 중 하나로 호출됩니다. APIFuse API 키만으로 호출하는 none 모드와, 사용자 단위 인증이 필요한 credentials 모드입니다.
핵심
connection이 필요한 operation은 호출 전에 조직 단위 connection(af_con_<22-char>)을 미리 만들어 두어야 합니다.
인증 모드
| 인증 모드 | 사용자 준비 사항 | 예시 |
|---|---|---|
none | APIFuse API 키만 필요 | 기상청, 카카오맵 공개 operation, 법령정보 등 |
credentials | APIFuse API 키 + connection ID 필요 | CatchTable의 내 예약 조회, 자리 대기 등록 등 사용자 인증이 필요한 operation |
none operation 호출
curl -X POST https://api.apifuse.com/v1/kakaomap/search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"서울역"}'connection 필요 operation 호출
connection이 필요한 operation은 게이트웨이 호출 시 connection 헤더를 함께 보냅니다.
curl -X POST https://api.apifuse.com/v1/catchtable/my-status \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-ApiFuse-Connection-Id: af_con_1234567890123456789012" \
-H "Content-Type: application/json" \
-d '{}'connection 생성과 자격 증명 입력은 플랫폼의 connection 설정 화면에서 안내에 따라 진행합니다. 생성된 connection ID(af_con_<22-char>)를 위 헤더에 사용하세요.