ClawOps APIKakao Channels

카카오 채널 인증번호 요청

View as Markdown
채널 권한을 증명하기 위한 인증번호를 **담당자 휴대전화로 발송**해 달라고 요청합니다. 채널 연결의 첫 단계입니다. **응답에 인증번호는 없습니다.** 인증번호는 카카오 비즈니스 채널에 등록된 담당자 휴대전화로만 전달되고, ClawOps 는 그 값을 받지도 저장하지도 않습니다. 그래서 성공 응답은 `200` 이 아니라 `202` 입니다 — "요청을 접수했고 결과는 다른 경로로 간다"는 뜻입니다. 받은 인증번호는 채널 연결(`POST /v1/accounts/{accountId}/kakao/channels`)에 `token` 으로 보냅니다. 인증번호에는 유효 시간이 있으므로 받은 뒤 바로 진행하세요. 재요청이 너무 잦으면 `429` 입니다. 응답의 `retryAfterSeconds` 만큼 기다린 뒤 다시 요청하세요.

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

Request

This endpoint expects an object.
searchIdstringRequired

카카오 채널 검색용 ID. @ 를 붙여 보내도 떼어내고 처리합니다.

phoneNumberstringRequired

인증번호를 받을 담당자 휴대전화번호. 하이픈·+82 형태 모두 허용됩니다. 카카오 비즈니스 채널에 관리자로 등록된 번호여야 인증번호가 발송됩니다.

Response

인증번호 발송 요청 접수 — 실제 인증번호는 담당자 휴대전화로 전달됩니다

requestedbooleanOptional

요청이 접수되었는지 여부

searchIdstringOptional

정규화된 검색용 ID. 다음 단계에 이 값을 그대로 보내세요.

phoneNumberMaskedstringOptional

인증번호가 발송된 번호(마스킹). 어느 번호로 갔는지 확인용입니다.

retryAfterSecondsintegerOptional

재요청까지 기다릴 시간(초)

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error
503
Service Unavailable Error