添付ファイルのアップロード

Prev Next

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

MMS送信のためにファイルをアップロードします。

リクエスト

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

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

リクエストヘッダ

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

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

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

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

リクエストボディ

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

フィールド タイプ 必須の有無 説明
fileName String Required 添付ファイル名
  • 0~40文字
  • jpg、jpeg拡張子を持つファイル名
fileBody String Required 添付ファイルの内容(Kbyte)
  • 0~300
  • jpg、jpeg画像を Base64でエンコードした値
  • 解像度は最大1500x1440まで
  • 接頭辞がある場合、削除が必要(<例> data:image/png;base64,)
参考

アップロード対象のファイルと同じ名前とサイズを持つファイルが既に存在する場合は、同じファイルと認識してファイルを再利用します (6日間保管)。

リクエスト例

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

curl --location --request POST 'https://sens.apigw.ntruss.com/sms/v2/services/ncp:sms:kr:50*********1:sens/files' \
--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 '{
    "fileName": "G0ufjqMy3wBpCucJenTaU.jpg",
    "fileBody": "/9j/4QC8RXhpZgAASUkqAAgAAAAGABIBAwABAAA...AAAAAAAAAAAAAAAAAAAAAAAAAAH/9k="
}'

レスポンス

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

レスポンスボディ

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

フィールド タイプ 必須の有無 説明
fileId String Required 添付ファイル ID
createTime String Required 添付ファイルの作成日時
  • YYYY-MM-DDTHH:mm:ss.sss形式
expireTime String Required 添付ファイルの有効期限
  • YYYY-MM-DDTHH:mm:ss.sss形式

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

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

レスポンス例

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

{
    "fileId": "a136************************74f7",
    "createTime": "2025-11-25T10:12:47.520",
    "expireTime": "2025-11-27T10:12:47.520"
}