자주 묻는 질문

센드온 SDK 사용 중 자주 발생하는 문제와 해결 방법을 안내합니다.

이 문서는 빠른 문제 해결과 최적의 사용자 경험을 제공합니다.


인증에 실패했어요
  • 문제: API 호출 시 "Unauthorized" 오류가 발생해요.
  • 원인:
    • 잘못된 API 키를 사용했을 수 있어요.
    • API 키가 만료되었을 가능성이 있어요.
    • 권한이 없는 API 키를 사용했을 수 있어요.
  • 해결 방법:
    • 센드온 콘솔에서 올바른 API 키를 확인해 주세요.
    • API 키를 환경 변수 또는 안전한 스토리지에 저장하고, 코드에서 정확히 참조하고 있는지 확인해 보세요.
    • 여전히 문제가 발생하면 관리자에게 문의해 도움을 요청하세요.
네트워크 오류가 발생했어요
  • 문제: "Network Error" 또는 "Request Timeout" 메시지가 표시돼요.
  • 원인:
    • API 엔드포인트 URL에 오타가 있을 수 있어요.
    • 네트워크 연결 상태가 불안정할 수 있어요.
    • 방화벽 설정이나 IP 화이트리스트 제한으로 인해 발생할 수 있어요.
  • 해결 방법:
    • SDK 초기화 시 입력한 엔드포인트 URL이 정확한지 확인해 주세요.
    • 네트워크 상태를 점검하거나, IP 화이트리스트 설정이 올바른지 확인해 보세요.
    • 잠시 후 요청을 다시 시도하거나, 코드에 재시도 로직을 추가해 보세요.
요청 데이터 유효성 검증에 실패했어요
  • 문제: API 호출 시 "Bad Request" 오류가 발생해요.
  • 원인:
    • 필수 입력 필드가 누락되었을 가능성이 있어요.
    • 요청 데이터의 형식이 잘못되었을 수 있어요.
  • 해결 방법:
    • SDK 문서를 참고하여 API 호출에 필요한 필수 필드가 누락되지 않았는지 확인해 주세요.
    • 요청 데이터의 형식이 올바른지 점검하고 수정해 보세요.
    • 유효성 검사를 코드에 추가하여 잘못된 데이터가 전달되지 않도록 사전에 방지하세요.
발송 제한을 초과했어요
  • 문제: "Rate Limit Exceeded" 오류가 발생했어요.
  • 원인:
    • 설정된 초당 또는 분당 요청 한도를 초과했을 가능성이 있어요.
  • 해결 방법:
    • 요청 빈도를 줄이거나 요청 간 대기 시간을 추가해 보세요.
    • 한도를 초과하는 요청이 필요한 경우, 센드온 지원팀에 문의해 한도 상향을 요청하세요.
응답 지연이 발생했어요
  • 문제: API 응답 시간이 길어지고 있어요.
  • 원인:
    • 서버 과부하로 인해 발생할 수 있어요.
    • 네트워크 지연 문제가 있을 수 있어요.
  • 해결 방법:
    • 요청 시간대를 조정해 트래픽이 적은 시간에 요청을 시도해 보세요.
    • 응답 시간 초과 처리를 위한 타임아웃 설정을 추가하세요.
    • 문제가 지속되면 센드온 지원팀에 문의해 보세요.
템플릿 검수 요청이 실패했어요
  • 문제: 카카오 템플릿 검수 요청이 거절되었어요.
  • 원인:
    • 템플릿 내용이 정책에 위배되었을 가능성이 있어요.
    • 누락된 필드나 잘못된 변수를 사용했을 수 있어요.
  • 해결 방법:
    • 템플릿 내용을 카카오 검수 가이드라인에 맞게 수정하세요.
    • 누락된 필드와 변수 이름이 올바르게 매핑되었는지 확인하세요.
    • 수정 후 다시 검수 요청을 제출해 보세요.