인증방식
Authorization이란?
SOLAPI는 공식 웹사이트 이외에도 개발자가 직접 서비스를 연동할 수 있도록 API를 제공합니다.
API 사용을 위해서는 사용자 신원 확인 과정(Authorization) 이 필요하며, SOLAPI는 다음 두 가지 인증 방식을 제공합니다:
| 인증 방식 | 적용 대상 | 설명 |
|---|---|---|
일반 개발자 | 직접 연동 방식 | |
앱 스토어 개발자 | 서드파티 앱 연동 방식 |
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 사용에 제한이 있을 수 있습니다.
| 인증 유형 | 대상 | 비고 |
|---|---|---|
개인 인증 | 개인 사용자 | 신분증 기반 인증 |
사업자 인증 | 기업/사업자 | 사업자등록증 기반 인증 |