본문으로 건너뛰기

인증 개요

Authorization이란?

SOLAPI는 공식 웹사이트 이외에도 개발자가 직접 서비스를 연동할 수 있도록 API를 제공합니다.

API 사용을 위해서는 사용자 신원 확인 과정(Authorization) 이 필요하며, SOLAPI는 다음 두 가지 인증 방식을 제공합니다:

인증 방식설명적용 대상
API Key 인증직접 연동 방식일반 개발자
OAuth2 인증서드파티 앱 연동 방식앱 스토어 개발자


API 사용 조건

SOLAPI API 사용 시 다음 5가지 조건을 모두 충족해야 합니다:

1. 계정 권한 (OAuth2 전용)

서드파티 앱 개발자 전용

이 항목은 APP STORE 앱 개발자에게만 해당됩니다.

서드파티 앱 개발 시 사용자로부터 다음과 같은 권한을 요청할 수 있습니다:

권한 유형:

  • 정보 접근 권한: 사용자의 캐시 정보 등 조회
  • 계정 활용 권한: 사용자 대신 문자 발송 등 실행

권한 요청 원칙:

  • 각 API마다 필요한 권한이 정의되어 있음
  • 사용자가 권한을 허용하지 않으면 해당 API 사용 불가
  • 과도한 권한 요청은 사용자 앱 사용률 저하 가능성

자세한 내용은 권한 목록을 참고하세요.


2. 회원 권한

SOLAPI는 계정(그룹) 내에 여러 회원이 속할 수 있는 구조입니다. 각 회원의 역할에 따라 API 사용 범위가 결정됩니다.

역할권한 레벨설명
OWNER최고 권한계정의 모든 기능 사용 가능
DEVELOPER개발 권한API 연동 및 개발 관련 기능 사용
MEMBER기본 권한제한된 기능만 사용 가능

자세한 내용은 회원 권한 목록을 참고하세요.


3. 계정 상태

상태설명API 사용 가능 여부
ACTIVE정상 사용 상태✅ 가능
INACTIVE휴면 계정 (1년 미사용)❌ 불가능 (인증 후 복구 가능)
DELETED삭제된 계정❌ 불가능 (복구 불가능)

4. 회원 상태

상태설명API 사용 가능 여부
UNVERIFIED이메일 인증 미완료⚠️ 제한적 사용
ACTIVE정상 사용 상태✅ 가능
INACTIVE휴면 회원 (1년 미사용)❌ 불가능 (인증 후 복구 가능)
DELETED삭제된 회원❌ 불가능 (복구 불가능)

5. 계정 인증

계정 사용 전 신원 증명이 필요합니다. 인증 완료 전까지는 API 사용에 제한이 있을 수 있습니다.

인증 유형대상비고
개인 인증개인 사용자신분증 기반 인증
사업자 인증기업/사업자사업자등록증 기반 인증