Classic/VPC環境で利用できます。
画像の詳細情報を照会します。
参考
画像は最大1年間保存され、その後は自動的に削除されます。
リクエスト
リクエスト形式を説明します。リクエスト形式は次の通りです。
| メソッド | URI |
|---|---|
| GET | /brandmessage/v2/services/{serviceId}/images/{imageId} |
リクエストヘッダ
Simple & Easy Notification Service APIで共通して使用されるヘッダの詳細は、Simple & Easy Notification Serviceのリクエストヘッダをご参照ください。
リクエストパスパラメータ
リクエストパスパラメータの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
serviceId |
String | Required | Biz Messageサービス ID
|
imageId |
String | Required | 画像 ID
|
リクエスト例
リクエストのサンプルコードは次の通りです。
curl --location --request GET 'https://sens.apigw.ntruss.com/brandmessage/v2/services/ncp:kkobizmsg:kr:27*********6:sens/images/5b19970c-****-****-****-c8ec1cd8f37e' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'
レスポンス
レスポンス形式を説明します。
レスポンスボディ
レスポンスボディの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
imageId |
String | Required | 画像 ID |
imageUrl |
String | Required | 画像 URL |
imageType |
String | Required | 画像ファイルタイプ
|
imageName |
String | Required | 画像ファイル名 |
createTime |
String | Required | 画像をアップロードした日時 |
レスポンスステータスコード
Simple & Easy Notification Service APIで共通して使用されるレスポンスステータスコードの詳細は、Simple & Easy Notification Serviceのレスポンスステータスコードをご参照ください。
レスポンス例
レスポンスのサンプルコードは次の通りです。
{
"imageId": "5b19970c-****-****-****-c8ec1cd8f37e",
"imageUrl": "https://mud-kage.kakao.com/dn/dhkJRb/***********/**********************/img_l.jpg",
"imageType": "BASIC",
"imageName": "myImage.jpg",
"createTime": "2025-11-27T17:29:06.253"
}