솔라피 개발자 샌드박스 홈페이지입니다. 실사용은 solapi.com 으로 이동해주세요!솔라피 개발자 샌드박스 홈페이지입니다. 실사용은 solapi.com 으로 이동해주세요!솔라피 개발자 샌드박스 홈페이지입니다. 실사용은 solapi.com 으로 이동해주세요!솔라피 개발자 샌드박스 홈페이지입니다. 실사용은 solapi.com 으로 이동해주세요!솔라피 개발자 샌드박스 홈페이지입니다. 실사용은 solapi.com 으로 이동해주세요!솔라피 개발자 샌드박스 홈페이지입니다. 실사용은 solapi.com 으로 이동해주세요!솔라피 개발자 샌드박스 홈페이지입니다. 실사용은 solapi.com 으로 이동해주세요!솔라피 개발자 샌드박스 홈페이지입니다. 실사용은 solapi.com 으로 이동해주세요!
API

소개

작성일 2026.02.26 | 수정일 2026.03.25

이 문서는 SOLAPI의 REST API Reference를 제공합니다.

lightbulb

Representational State Transfer의 약자로, API 연동 규격을 명확하게 정의하고 쉽게 구현할 수 있는 아키텍처 스타일입니다.
자세한 내용은 Wikipedia를 참고하세요.


API 요청 규격 및 보안

대부분의 SOLAPI REST API 는 사용하기 위해서 인증 과정이 필요합니다.

Content-Type데이터 형식문자 인코딩Authorization
application/jsonJSONUTF-8HMAC_SHA256

Resource URL 구성

https://api.solapi.com/<ServiceName>/<Version>/<ResourcePath></ResourcePath>

URL 구성 요소

구성 요소예시설명
ServiceNamemessages, balance, images서비스 종류
Versionv4API 버전
ResourcePath/send, /list, ...리소스 경로

Query Operator 가이드

Operator(오퍼레이터) 는 SOLAPI의 고급 검색 기능으로, URL Query Parameter를 사용할 때 정교한 필터링을 가능하게 합니다.

API를 통해 SOLAPI 서비스를 효과적으로 활용하려면 오퍼레이터 사용법 숙지해야합니다.
eq 오퍼레이터가 지원되지 않는 필드에서는 기본 오퍼레이터도 사용할 수 없습니다.

오퍼레이터 종류

오퍼레이터기능주요 사용 케이스설명
*(기본값)Equal정확한 값 매칭eq와 동일한 동작
eqEqual상태, ID 검색값과 정확히 일치
neNot Equal특정 값 제외값과 일치하지 않음
likeLike텍스트 검색값을 포함
gteGreater Than or Equal날짜 범위(시작)크거나 같음
lteLess Than or Equal날짜 범위(끝)작거나 같음
gtGreater Than날짜 이후초과
ltLess Than날짜 이전미만
inIn다중 선택여러 값 중 하나와 일치
warning

기능별 오퍼레이터 사용법이 상이할 수 있습니다. 메시지 조회시 여기를 참조하세요.

실제 사용 예시

쿼리 파라미터OperatorDescription
title[like]=공지like제목에 "공지"가 포함된 메시지
title[ne]=공지사항ne제목이 "공지사항"이 아닌 메시지
status=COMPLETEeq발송 완료된 메시지
dateCreated[gte]=2026-01-01gte2026년 1월 1일 이후 생성
dateCreated[lt]=2026-02-01lt2026년 2월 1일 이전 생성
type[in]=["SMS","LMS"]inSMS 또는 LMS 타입

오류 처리

{
  "statusCode": "2000",
  "statusMessage": "정상 발송",
  "data": {}
}
{
  "errorCode": "4000",
  "errorMessage": "잘못된 요청입니다."
}
error

각 API별 상세한 오류 코드는 Message Status Codes 문서를 참고하세요.