APoT

파일 업로드

APoT에서 워터마킹이나 검증을 수행하기 전에 파일을 업로드해야 합니다. 이 페이지에서는 파일 업로드 링크를 생성하고 실제 파일을 업로드하는 방법에 대해 설명합니다.

파일 업로드 프로세스

APoT API에서 파일을 처리하기 위한 전체 프로세스는 다음과 같습니다:

  1. 파일 업로드 링크 생성 API를 호출하여 안전한 업로드 URL을 받습니다.
  2. 받은 URL로 파일을 업로드합니다.
  3. 업로드된 파일 ID를 사용하여 워터마킹 또는 검증 API를 호출합니다.

파일 업로드 링크 모델

파일 업로드 링크 응답은 다음 속성을 포함합니다:

  • Name
    fileId
    Type
    string
    Description

    업로드할 파일의 고유 식별자입니다.

  • Name
    uploadLink
    Type
    string
    Description

    파일을 업로드할 수 있는 임시 URL입니다.

POST/claim/file-upload-link

파일 업로드 링크 생성하기

이 엔드포인트는 파일을 업로드할 수 있는 서명된 URL을 생성합니다. 이 URL은 일정 시간 동안만 유효합니다.

선택적 요청 매개변수

  • Name
    contentType
    Type
    string
    Description

    업로드할 파일의 MIME 타입입니다.

  • Name
    fileName
    Type
    string
    Description

    업로드할 파일의 이름입니다.

요청

POST
/claim/file-upload-link
curl -X POST https://api.apot.io/claim/file-upload-link \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "contentType": "image/jpeg",
    "fileName": "example.jpg"
  }'

응답

{
  "fileId": "2ca0b132-cf83-4158-9353-121ff62a351e",
  "uploadLink": "https://storage.apot.io/upload/2ca0b132-cf83-4158-9353-121ff62a351e?signature=..."
}
POST/claim/file-upload-link

파일 업로드하기

파일 업로드 링크 생성 API에서 받은 URL로 파일을 직접 업로드합니다. 이 URL은 임시적이며 일정 시간이 지나면 만료됩니다.

주의사항

  • 업로드는 HTTP PUT 요청을 사용합니다.
  • 요청 헤더에 Content-Type을 파일의 MIME 타입으로 설정해야 합니다.
  • 업로드 URL은 보안상의 이유로 일반적으로 15분 동안만 유효합니다.

요청

PUT
curl -X PUT "https://storage.apot.io/upload/2ca0b132-cf83-4158-9353-121ff62a351e?signature=..." \
  -H "Content-Type: image/jpeg" \
  --data-binary "@example.jpg"

응답

// 성공 시 HTTP 상태 코드 200이 반환됩니다.
// 응답 본문은 비어 있습니다.

다음 단계

파일 업로드가 완료되면 반환된 fileId를 사용하여 워터마킹 또는 검증 API를 호출할 수 있습니다.

Was this page helpful?