メッセージの送信

Prev Next

Classic/VPC環境で利用できます。

SMS/LMS/MMSメッセージを送信します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
POST /sms/v2/services/{serviceId}/messages

リクエストヘッダ

Simple & Easy Notification Service APIで共通して使用されるヘッダの詳細は、Simple & Easy Notification Serviceのリクエストヘッダをご参照ください。

リクエストパスパラメータ

リクエストパスパラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
serviceId String Required SMSサービス ID

リクエストボディ

リクエストボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
type String Required メッセージタイプ
  • SMS | LMS | MMS
    • SMS: SMSメッセージ
    • LMS: LMSメッセージ
    • MMS: MMSメッセージ
contentType String Optional メッセージコンテンツタイプ
  • COMM (デフォルト) | AD
    • COMM: 一般用
    • AD: 広告用
countryCode String Optional 国コード
from String Required 送信番号
subject String Optional デフォルトのメッセージ件名(Byte)
  • 0~40
  • LMS、MMSでのみ使用可能
content String Required デフォルトのメッセージ内容(Byte)
  • SMS: 0~90
  • LMS、MMS: 0~2000
messages Array Required メッセージ情報
  • 最大100件入力可能
files Array Optional 添付ファイルリスト
  • MMSでのみ使用可能
  • typeでMMSを選択した場合でも、添付ファイルがないと LMSで送信
reserveTime String Optional 予約日時
  • YYYY-MM-DD HH:mm形式
  • 予約送信する場合、入力
reserveTimeZone String Optional 予約タイムゾーン
参考
  • サポート可能な最大サイズを超えると、一部の内容が切り捨てられて送信されます。
  • メッセージの件名および内容のエンコードは EUC-KRベースで送信され、サポートしていない絵文字を含めると送信は失敗します。
  • messages内のsubject、contentがデフォルトのsubject、contentより優先順位が高いです。
  • MMSタイプなのに添付するファイルがない場合は LMSで送信されます。

messages

messagesの説明は次の通りです。

フィールド タイプ 必須の有無 説明
to String Required 受信番号
  • 数字のみ入力可能
subject String Optional 個々のメッセージ件名(Byte)
  • 0~40
  • LMS、MMSでのみ使用可能
  • 入力しないとデフォルトのメッセージ件名を適用
content String Optional 個々のメッセージ内容(Byte)
  • SMS: 0~90
  • LMS、MMS: 0~2000
  • 入力しないとデフォルトのメッセージ内容を適用

files

filesの説明は次の通りです。

フィールド タイプ 必須の有無 説明
fileId String Required 添付ファイル ID

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request POST 'https://sens.apigw.ntruss.com/sms/v2/services/ncp:sms:kr:50*********1:sens/messages' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \
--data '{
    "type": "MMS",
    "contentType": "COMM",
    "countryCode": "82",
    "from": "010********",
    "subject": "Delivery Notification",
    "content": "Hello. This is for notifying your delivery status.",
    "messages": [
        {
            "to": "010********",
            "subject": "Delivery Noti",
            "content": "Hello, ******. This is for notifying your delivery status."
        }
    ],
    "files": [
        {
            "fileId": "a136************************74f7"
        }
    ],
    "reserveTime": "2025-11-25 09:50",
    "reserveTimeZone": "Asia/Seoul"
}'

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
requestId String Required リクエスト ID
requestTime String Required リクエスト日時
  • YYYY-MM-DDTHH:mm:ss.sss形式
statusCode String Required 状態コード
  • HTTPステータスコード規格に準拠
    • 202: 成功
    • その他: 失敗
statusName String Required 状態
  • success | fail
    • success: 成功
    • fail: 失敗

レスポンスステータスコード

Simple & Easy Notification Service APIで共通して使用されるレスポンスステータスコードの詳細は、Simple & Easy Notification Serviceのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
    "requestId": "RSLA-*************-****-********-IZJQgZEc",
    "requestTime": "2025-11-25T09:39:40.535",
    "statusCode": "202",
    "statusName": "success"
}