인증 개요
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 사용에 제한이 있을 수 있습니다.
인증 유형 | 대상 | 비고 |
---|---|---|
개인 인증 | 개인 사용자 | 신분증 기반 인증 |
사업자 인증 | 기업/사업자 | 사업자등록증 기반 인증 |