이 디렉토리에는 SOLAPI Rust SDK의 다양한 사용 예제가 포함되어 있습니다.
examples/
├── message_send_sms.rs # SMS 단건 전송 (동기 API)
├── message_send_lms.rs # LMS 장문 전송 (동기 API)
├── message_send_mms.rs # MMS 사진 문자 전송 (비동기 API, 이미지 업로드 포함)
├── message_send_multiple.rs # 다중 수신자 전송 (동기 API)
├── message_send_alimtalk.rs # 카카오 알림톡 단건 전송 (동기 API)
├── message_send_scheduled.rs # 예약 발송 (동기 API)
├── message_send_async.rs # SMS 전송 (비동기 API)
├── message_send_voice.rs # 음성 메시지 전송 (동기 API)
├── storage_upload_file.rs # 파일 업로드 (비동기 API)
├── example.jpg # MMS 예제용 샘플 이미지
└── README.md # 이 파일
모든 예제를 실행하기 전에 다음 환경 변수를 설정해야 합니다:
export SOLAPI_API_KEY="your_api_key"
export SOLAPI_API_SECRET="your_api_secret"
# 발송 예제의 경우에만 설정
export FROM_PHONE="01012345678" # 발신번호 (사전 등록 필요)
export TO_PHONE="01087654321" # 수신번호# 프로젝트 루트에서 실행
cargo run --example message_send_smscargo run --example message_send_sms- 기본적인 SMS(단문 문자) 전송 예제
- 동기 API 사용
cargo run --example message_send_lms- 최대 2,000byte까지 전송 가능한 장문 문자 예제
- 제목(subject) 설정 가능
cargo run --example message_send_mms
# 또는 커스텀 이미지 파일 사용
cargo run --example message_send_mms <이미지_파일_경로>- 이미지가 포함된 MMS 전송 예제
- Storage API를 통한 이미지 업로드 후 전송
- 기본적으로
examples/example.jpg사용
cargo run --example message_send_multiple- 한 번의 요청으로 여러 수신자에게 메시지 전송
cargo run --example message_send_alimtalk- 카카오톡 알림톡 전송 예제
- 템플릿 ID와 변수 치환 기능 활용
cargo run --example message_send_scheduled- 특정 시간에 메시지를 예약 발송하는 예제
cargo run --example message_send_async- Tokio 런타임을 사용한 비동기 메시지 전송 예제
cargo run --example message_send_voice- 음성 메시지(Voice) 전송 예제
cargo run --example storage_upload_file <이미지_파일_경로>- Storage API를 사용한 파일 업로드 예제
- MMS 발송 전 이미지 업로드에 사용
- MMS 전송 시 이미지는 먼저 Storage API를 통해 업로드한 후 반환된
file_id를 사용합니다. - 환경 변수는
.env파일을 사용하거나 직접 export로 설정할 수 있습니다. - 발신번호는 SOLAPI 콘솔에서 사전 등록이 필요합니다.