RECIPE 부록B
국내 서비스 API 발급 & n8n 연동 가이드
- ▸카카오·네이버·토스 등 주요 국내 서비스 API 키를 발급받을 수 있다
- ▸각 서비스를 n8n HTTP Request 노드로 연동하는 기본 패턴을 익힐 수 있다
- ▸API 인증 방식(API Key / OAuth2 / Bearer Token)별 n8n 설정 방법을 이해할 수 있다
✅API 발급 전 공통 체크사항
- □사업자등록번호 또는 개인 인증 준비 (일부 API 필수)
- □서비스 이용약관 및 개인정보처리방침 확인
- □API 호출 제한(Rate Limit) 사전 확인
- □테스트 환경(Sandbox)과 운영 환경 API 키 분리 발급
- □API 키는 n8n Credentials에만 저장 (코드에 직접 입력 금지)
카카오 API 발급 & 연동
[발급 경로]
https://developers.kakao.com
→ 앱 만들기 → 앱 키 확인 (REST API 키 사용)
[카카오 알림톡 추가 설정]
https://business.kakao.com
→ 카카오톡 채널 개설 → 알림톡 서비스 신청
→ 발신 프로필 키(Sender Key) 발급
→ 메시지 템플릿 등록 및 승인 (1~3 영업일)
[n8n HTTP Request 설정]
URL: https://kapi.kakao.com/v2/user/me
Method: GET
Authentication: Header Auth
Header Name: Authorization
Header Value: Bearer {{ $credentials.accessToken }}
[알림톡 발송 (aligo 대행)]
URL: https://kakaoapi.aligo.in/akv10/alimtalk/send/
Method: POST
Body Type: Form Data
Fields:
apikey: YOUR_ALIGO_KEY
userid: YOUR_ALIGO_ID
senderkey: YOUR_SENDER_KEY
tpl_code: 템플릿코드
receiver_1: {{ $json.phone }}
message_1: {{ $json.message }}네이버 API 발급 & 연동
[네이버 개발자센터 공통 API]
https://developers.naver.com
→ 앱 등록 → Client ID / Client Secret 발급
[n8n HTTP Request — 네이버 검색 API]
URL: https://openapi.naver.com/v1/search/news.json
Method: GET
Authentication: Header Auth (두 개 추가)
X-Naver-Client-Id: {{ $credentials.clientId }}
X-Naver-Client-Secret: {{ $credentials.clientSecret }}
Query Params:
query: 검색어
display: 10
sort: date
[네이버 스마트스토어 API]
https://developers.naver.com/products/commerce
→ 커머스 API 신청 (사업자 계정 필요)
→ Access Token 발급:
URL: https://api.commerce.naver.com/external/v1/oauth2/token
Method: POST
Body: grant_type=client_credentials
&client_id=YOUR_CLIENT_ID
×tamp=현재타임스탬프
&client_secret_sign=HMAC_SHA256_서명토스페이먼츠 API 발급 & 연동
[발급 경로]
https://developers.tosspayments.com
→ 테스트 연동 시작 → 테스트 API 키 즉시 발급
→ 운영 전환 시: 사업자 정보 입력 후 심사 (3~5 영업일)
[인증 방식: Basic Auth]
Secret Key를 Base64 인코딩 후 사용
Authorization: Basic BASE64(secretKey + ":")
[n8n 결제 조회 HTTP Request]
URL: https://api.tosspayments.com/v1/payments/{{ $json.paymentKey }}
Method: GET
Authentication: Basic Auth
Username: YOUR_SECRET_KEY
Password: (빈칸)
[Webhook 수신 설정]
토스 대시보드 → 웹훅 URL 등록:
https://your-n8n.com/webhook/toss-payment
이벤트:
- payment.done (결제 완료)
- payment.canceled (결제 취소)채널톡 API 발급 & 연동
[발급 경로]
https://developers.channel.io
→ 채널 설정 → 개발자 도구 → API 키 발급
[n8n HTTP Request — 상담 목록 조회]
URL: https://api.channel.io/open/v5/user-chats
Method: GET
Authentication: Header Auth
Header Name: x-access-key
Header Value: YOUR_CHANNEL_ACCESS_KEY
Query Params:
state: opened
limit: 20
[Webhook 수신 — 새 상담 실시간 감지]
채널톡 대시보드 → 웹훅 설정:
URL: https://your-n8n.com/webhook/channel-talk
이벤트: userChat.opened
n8n Webhook 노드에서 수신 후
→ 상담 유형 분류
→ Slack 해당 담당자 DM 라우팅💡 TIPn8n Credentials 기능을 적극 활용하세요. API 키를 Credentials로 등록하면 여러 워크플로우에서 재사용할 수 있고, 키 변경 시 Credentials 한 곳만 수정하면 모든 워크플로우에 즉시 반영됩니다. Settings → Credentials → New Credential → Generic Credential Type으로 등록하면 됩니다.
⚠️ 주의국내 서비스 API는 서비스 약관에 따라 상업적 이용 가능 여부가 다릅니다. 특히 네이버 검색 API는 비상업적 용도로만 무료 사용이 가능하며, 상업적 목적으로는 별도 계약이 필요합니다. 사용 전 반드시 각 서비스의 이용약관을 확인하세요.