API

인증방식

작성일 2026.02.27 | 수정일 2026.02.27

Authorization이란?

SOLAPI는 공식 웹사이트 이외에도 개발자가 직접 서비스를 연동할 수 있도록 API를 제공합니다.
API 사용을 위해서는 사용자 신원 확인 과정(Authorization) 이 필요하며, SOLAPI는 다음 두 가지 인증 방식을 제공합니다:

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

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

계정 권한 (OAuth2 전용)

이 항목은 서드파티 APP STORE 앱 개발자에게만 해당됩니다.
서드파티 앱 개발 시 사용자로부터 다음과 같은 권한을 요청할 수 있습니다.

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

warning

필요 권한 정의: 각 API마다 필요한 권한이 정의되어 있습니다.
권한 허용 필수: 사용자가 권한을 허용하지 않으면 해당 API 사용 불가합니다.
과도한 권한 요청 금지: 과도한 권한 요청은 사용자 앱 사용률 저하 가능성이 있습니다.
자세한 내용은 TODO권한 목록을 참고하세요.

회원 권한

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

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

계정 상태

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

회원 상태

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

계정 인증

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

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