Merge pull request #13 from Palbahngmiyine/main

SOLAPI Python 5.0.1 GA

Author: Palbahngmiyine

examples/messages/get_messages.py

@@ -1,4 +1,5 @@
 from solapi import SolapiMessageService
+
 # from solapi.model.request.messages.get_messages import GetMessagesRequest
 
 message_service = SolapiMessageService(

examples/simple/send_kakao_alimtalk.py

@@ -1,5 +1,5 @@
 from solapi import SolapiMessageService
-from solapi.model import Message
+from solapi.model import RequestMessage
 from solapi.model.kakao.kakao_option import KakaoOption
 
 # API 키와 API Secret을 설정합니다
@@ -20,7 +20,7 @@
 )
 
 # 단일 메시지를 생성합니다
-message = Message(
+message = RequestMessage(
     from_="발신번호",  # 발신번호 (등록된 발신번호만 사용 가능)
     to="수신번호",  # 수신번호
     kakao_options=kakao_option,

examples/simple/send_many.py

@@ -1,5 +1,5 @@
 from solapi import SolapiMessageService
-from solapi.model import Message, SendRequestConfig
+from solapi.model import RequestMessage, SendRequestConfig
 
 # API 키와 API Secret을 설정합니다
 message_service = SolapiMessageService(
@@ -8,9 +8,9 @@
 
 # 여러 메시지를 생성합니다
 messages = [
-    Message(from_="발신번호", to="수신번호1", text="첫 번째 메시지입니다."),
-    Message(from_="발신번호", to="수신번호2", text="두 번째 메시지입니다."),
-    Message(from_="발신번호", to="수신번호3", text="세 번째 메시지입니다."),
+    RequestMessage(from_="발신번호", to="수신번호1", text="첫 번째 메시지입니다."),
+    RequestMessage(from_="발신번호", to="수신번호2", text="두 번째 메시지입니다."),
+    RequestMessage(from_="발신번호", to="수신번호3", text="세 번째 메시지입니다."),
 ]
 
 # SendRequestConfig를 사용하여 중복 수신번호 허용 설정

examples/simple/send_mms.py

@@ -1,7 +1,7 @@
 from os.path import abspath
 
 from solapi import SolapiMessageService
-from solapi.model import Message
+from solapi.model import RequestMessage
 from solapi.model.request.storage import FileTypeEnum
 
 # API 키와 API Secret을 설정합니다
@@ -23,7 +23,7 @@
     print(f"File ID: {file_response.file_id}")
 
     # MMS 메시지를 생성하고 발송합니다
-    message = Message(
+    message = RequestMessage(
         from_="발신번호",  # 발신번호 (등록된 발신번호만 사용 가능)
         to="수신번호",  # 수신번호
         # subject="MMS 제목", # MMS 제목, 제목을 지정하지 않는다면 필요하지 않습니다.

examples/simple/send_sms.py

@@ -1,13 +1,13 @@
 from solapi import SolapiMessageService
-from solapi.model import Message
+from solapi.model import RequestMessage
 
 # API 키와 API Secret을 설정합니다
 message_service = SolapiMessageService(
     api_key="YOUR_API_KEY", api_secret="YOUR_API_SECRET"
 )
 
 # 단일 메시지를 생성합니다
-message = Message(
+message = RequestMessage(
     from_="발신번호",  # 발신번호 (등록된 발신번호만 사용 가능)
     to="수신번호",  # 수신번호
     text="안녕하세요! SOLAPI Python SDK를 사용한 SMS 발송 예제입니다.",

examples/simple/send_sms_with_reservation.py

@@ -1,15 +1,15 @@
 from datetime import datetime
 
 from solapi import SolapiMessageService
-from solapi.model import Message, SendRequestConfig
+from solapi.model import RequestMessage, SendRequestConfig
 
 # API 키와 API Secret을 설정합니다
 message_service = SolapiMessageService(
     api_key="YOUR_API_KEY", api_secret="YOUR_API_SECRET"
 )
 
 # 단일 메시지를 생성합니다
-message = Message(
+message = RequestMessage(
     from_="발신번호",  # 발신번호 (등록된 발신번호만 사용 가능)
     to="수신번호",  # 수신번호
     text="안녕하세요! SOLAPI Python SDK를 사용한 SMS 발송 예제입니다.",

examples/webhook/django_example/.python-version

@@ -0,0 +1 @@
+3.9

examples/webhook/django_example/README.md

@@ -0,0 +1,20 @@
+# SOLAPI Django Webhook 예제
+
+- 해당 예제는 Django에서 SOLAPI에서 제공하는 webhook을 통해 파라미터를 수신할 때 solapi 모듈을 이용하여 메시지 리포트, 그룹 리포트 데이터를 받아오는 예제입니다.
+- 해당 예제는 uv를 통해 패키지를 관리하고 있습니다. 따라서 사전에 [uv](https://docs.astral.sh/uv/getting-started/installation/)가 설치되어 있어야합니다.
+
+## Getting Started
+
+예제를 다운로드 받은 직후, 아래의 명령어를 Django 프로젝트 경로에서 입력해주세요.
+
+```bash
+uv sync
+```
+
+그다음 Django 서버를 실행하려면 아래의 명령어를 실행해주세요.
+
+```bash
+uv run manage.py runserver
+```
+
+이후에는 `POST http://localhost:8080/webhook/single-report` 또는 `POST http://localhost:8080/webhook/group-report`로 웹훅 데이터를 수신하여 테스트해 볼 수 있습니다.