인증 - AllTalk Developers

AllTalk API는 요청 헤더의 apikey 값으로 인증합니다.

apikey, service, groupId 는 관리자 로그인 후 내정보 → API / 채널 정보 탭에서 확인할 수 있습니다. 자세한 방법은 API 키 발급 페이지를 참고하세요.

헤더 형식

apikey: {API_KEY}
Content-Type: application/json

예제

curl -X POST https://api.alltalk.co.kr/alimTalk \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d @payload.json

import axios from 'axios';

await axios.post('https://api.alltalk.co.kr/alimTalk', talkData, {
  headers: { apikey: process.env.ALLTALK_API_KEY },
});

import os
import requests

requests.post(
    'https://api.alltalk.co.kr/alimTalk',
    json=talk_data,
    headers={'apikey': os.environ['ALLTALK_API_KEY']},
)

보안 주의사항

apikey는 서버 사이드에서만 사용하세요. 프론트엔드나 공개 저장소에 노출되면 안 됩니다.
환경변수 또는 Secret Manager를 통해 관리하세요.
유출이 의심되면 즉시 관리자 내정보 → API / 채널 정보 에서 재발급하세요.

인증 실패 시

에러 코드	설명
`ERR_100`	`authToken` 데이터 누락
`ERR_102`	header 데이터 미일치 (인증 실패)

자세한 에러 코드는 에러 코드 페이지를 참고하세요.