APIFuse

인증과 connection

APIFuse operation의 인증 모드와 connection 필요 여부를 설명합니다.

인증과 connection

APIFuse operation은 두 가지 인증 모드 중 하나로 호출됩니다. APIFuse API 키만으로 호출하는 none 모드와, 사용자 단위 인증이 필요한 credentials 모드입니다.

핵심

connection이 필요한 operation은 호출 전에 조직 단위 connection(af_con_<22-char>)을 미리 만들어 두어야 합니다.

인증 모드

인증 모드사용자 준비 사항예시
noneAPIFuse API 키만 필요기상청, 카카오맵 공개 operation, 법령정보 등
credentialsAPIFuse 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>)를 위 헤더에 사용하세요.