연동 설정
API 키 관리
파트너에게 줄 API 키를 발급하고 폐기하는 방법입니다.
API 키란#
외부 서비스(연동 파트너)가 이 시스템에 문의를 넘기고 답변을 가져갈 때 쓰는 비밀 열쇠입니다. 키 하나는 프로젝트 하나에 묶입니다. 그 키로 들어온 이슈는 해당 프로젝트로 접수되고, 그 키는 자기가 접수한 이슈만 볼 수 있습니다.
파트너가 여럿이면 파트너마다 키를 따로 발급하세요. 그래야 파트너끼리 서로의 이슈를 볼 수 없고, 한 곳만 골라 폐기할 수 있습니다.
발급하기#
1
프로젝트 설정의 API 키 탭에서 프로젝트를 고릅니다
2
발급처 이름을 입력하고 발급합니다
이름은 파트너를 알아볼 수 있게 짓습니다(예: 쇼핑몰A). 이 이름은 이슈 등록 화면의 연동 API KEY 선택지에도 쓰입니다.
3
화면에 나온 키를 즉시 복사해 파트너에게 안전하게 전달합니다
키 원문은 발급 직후 이 화면에서만 보입니다. 화면을 벗어나면 다시 볼 수 없고, 잃어버리면 새로 발급해야 합니다.
파트너에게 함께 전달할 것#
- 발급한 API 키 (메신저 대화방처럼 기록이 남는 곳에 붙여넣지 않도록 주의)
- 연동 문서 - 이 탭의 API 가이드와 같은 내용의 파트너용 문서가 따로 준비돼 있습니다
- 팝업 방식이면 포털 화면 설정(로고·색상)을 미리 해두세요
폐기#
키가 유출됐거나 파트너와 연동을 끝내면 폐기합니다. 폐기된 키로는 즉시 요청이 거부되고 되살릴 수 없습니다. 자동 만료는 없으니, 교체가 필요하면 새 키를 먼저 발급해 파트너가 바꾼 뒤 옛 키를 폐기하세요.
주의
키를 폐기하면 그 키로 들어온 이슈는 목록에서 미연동으로 표시되고 더 이상 외부로 전달되지 않습니다. 이미 접수된 이슈 자체는 그대로 남습니다.