새로운 문서를 작성 중입니다.새 문서로 이동
ClawOps Docs
API Reference

카카오 채널 인증번호 요청

POST
/v1/accounts/{accountId}/kakao/channels/token

채널 권한을 증명하기 위한 인증번호를 담당자 휴대전화로 발송해 달라고 요청합니다. 채널 연결의 첫 단계입니다.

응답에 인증번호는 없습니다. 인증번호는 카카오 비즈니스 채널에 등록된 담당자 휴대전화로만 전달되고, ClawOps 는 그 값을 받지도 저장하지도 않습니다. 그래서 성공 응답은 200 이 아니라 202 입니다 — "요청을 접수했고 결과는 다른 경로로 간다"는 뜻입니다.

받은 인증번호는 채널 연결(POST /v1/accounts/{accountId}/kakao/channels)에 token 으로 보냅니다. 인증번호에는 유효 시간이 있으므로 받은 뒤 바로 진행하세요.

재요청이 너무 잦으면 429 입니다. 응답의 retryAfterSeconds 만큼 기다린 뒤 다시 요청하세요.

Authorization

BearerAuth
AuthorizationBearer <token>

API Key를 Bearer 토큰으로 전달

In: header

Path Parameters

accountId*string

계정 ID

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/accounts/AC1a2b3c4d/kakao/channels/token" \  -H "Content-Type: application/json" \  -d '{    "searchId": "example",    "phoneNumber": "010-1234-5678"  }'
{
  "requested": true,
  "searchId": "example",
  "phoneNumberMasked": "010-****-5678",
  "retryAfterSeconds": 60
}
{
  "error": "string",
  "code": "recipient_blocked"
}
{
  "error": "string",
  "code": "recipient_blocked"
}
{
  "error": "string",
  "code": "recipient_blocked"
}
{
  "error": "string",
  "code": "recipient_blocked"
}
{
  "error": "string",
  "code": "recipient_blocked"
}