API 키 발급

AllTalk API를 사용하려면 다음 3가지 값이 필요합니다.

항목	용도
`apikey`	모든 API 요청 헤더에 포함
`service`	발송 시 body에 포함 (채널별 서비스 번호)
`groupId`	발송 시 body · 헤더에 포함 (그룹 식별자)

관리자 로그인

admin.alltalk.co.kr 접속 후 계정으로 로그인합니다.

내정보 메뉴 진입

우측 상단 프로필 이미지를 클릭한 후, 나타난 메뉴에서 내정보를 클릭합니다.

키 값 복사

내정보 페이지의 API / 채널 정보 탭에서 각 항목 옆의 복사 버튼을 눌러 값을 복사합니다.

API 키 확인 화면 — apikey / service / groupId 확인

apikey는 외부에 노출되면 안 됩니다. 환경변수 또는 Secret Manager에 저장하고, 프론트엔드 코드에 하드코딩하지 마세요.

요청에 적용

받은 값을 API 요청에 사용합니다.

await axios.post('https://api.alltalk.co.kr/sms', {
  service: 1234567890,          // 위에서 복사한 service
  groupId: 'YOUR_GROUP_ID',       // 위에서 복사한 groupId
  message: '안녕하세요',
  numbers: ['01012345678'],
  callbackNo: '16612460',
}, {
  headers: {
    apikey: process.env.ALLTALK_API_KEY,   // 위에서 복사한 apikey
    groupId: 'YOUR_GROUP_ID',
  },
});

자주 묻는 질문

키가 보이지 않아요

계정에 API 사용 권한이 활성화되지 않았을 수 있습니다. 영업 담당자에게 문의해주세요.

키가 유출된 것 같아요

즉시 관리자 개발자 → API Key 에서 재발급을 누르세요. 기존 키는 즉시 무효화되고 새 키가 발급됩니다.

여러 서비스에 하나의 키를 써도 되나요?

apikey는 계정 단위, service는 채널 단위입니다. 여러 발송 채널이 있다면 service 값만 다르게 사용하고 apikey는 동일하게 사용합니다.

시작하기

참조

자주 묻는 질문

​자주 묻는 질문

자주 묻는 질문