story-dict

미리 서명된 URL

Develop Env

POST

/apis/v1/images/presigned-url

Request

Body Params application/json

filename

string

required

업로드할 파일명

status

enum<string>

required

이미지 상태

Allowed values:

tempusedeleted

Default:

temp

Example

{
  "filename": "ninja.png",
  "status": "temp"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://localhost:9050/apis/v1/images/presigned-url' \
--header 'Content-Type: application/json' \
--data-raw '{
    "filename": "ninja.png",
    "status": "temp"
}'

Responses

🟢201🟢 미리 서명된 URL 요청 성공

application/json

Body

payload

object

required

@aws-sdk/s3-presigned-post에서 주는 응답값

url

string

required

이미지가 업로드될 URL

fields

object

required

S3에 생성 시 FormData로 전달할 값

Example

{
  "payload": {
    "url": "https://storydict.s3.ap-northeast-2.amazonaws.com/",
    "fields": {
      "bucket": "storydict",
      "X-Amz-Algorithm": "AWS4-HMAC-SHA256",
      "X-Amz-Credential": "AKIARYEUCSJI6VDGQZOP/20241208/ap-northeast-2/s3/aws4_request",
      "X-Amz-Date": "20241208T074101Z",
      "key": "images/development/TEMP/1733643661851.png",
      "Policy": "eyJleHBpcmF0aW9uIjoiMjAyNC0xMi0wOFQwNzo0MjowMVoiLCJjb25kaXRpb25zIjpbWyJjb250ZW50LWxlbmd0aC1yYW5nZSIsMCw1MjQyODgwMF0sWyJzdGFydHMtd2l0aCIsIiRDb250ZW50LVR5cGUiLCJpbWFnZS8iXSx7ImJ1Y2tldCI6InN0b3J5ZGljdCJ9LHsiWC1BbXotQWxnb3JpdGhtIjoiQVdTNC1ITUFDLVNIQTI1NiJ9LHsiWC1BbXotQ3JlZGVudGlhbCI6IkFLSUFSWUVVQ1NKSTZWREdRWk9QLzIwMjQxMjA4L2FwLW5vcnRoZWFzdC0yL3MzL2F3czRfcmVxdWVzdCJ9LHsiWC1BbXotRGF0ZSI6IjIwMjQxMjA4VDA3NDEwMVoifSx7ImtleSI6ImltYWdlcy9kZXZlbG9wbWVudC9URU1QLzE3MzM2NDM2NjE4NTEucG5nIn1dfQ==",
      "X-Amz-Signature": "4abc48e32d978e980f0aea610e21cefb496d98e6c6b4d9b6f65383f5c0ba8d1a"
    }
  }
}

🟠400🔴 유효성 검사 실패

Modified at 2025-01-14 08:34:09

회원가입

이미지 이동