발행일: 2026-10-06(화) 11:44
← 목차로 돌아가기|하루 30분 n8n 시리즈 ② 실무 자동화 레시피 100
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
          &timestamp=현재타임스탬프
          &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는 비상업적 용도로만 무료 사용이 가능하며, 상업적 목적으로는 별도 계약이 필요합니다. 사용 전 반드시 각 서비스의 이용약관을 확인하세요.
← 이전 레시피☰ 목차다음 레시피 →