TikTok·Instagram·YouTube·Facebook 발행에는 같은 워크스페이스에서 완료 확인된 mediaId를 사용합니다. Facebook 텍스트 FEED에는 미디어가 없어도 됩니다.

기존 파일 선택

curl --request GET "https://www.posteady.com/api/v1/media?mediaType=IMAGE&limit=20&offset=0" \
  --header "Authorization: Bearer $POSTEADY_API_KEY"

응답의 media 배열에서 ID를 선택하세요. total과 hasMore로 다음 페이지를 판단하고 offset을 늘립니다. 영상은 mediaType=VIDEO를 지정하세요. 생략해도 VIDEO입니다. limit은 1–100(기본 20), offset은 0–10,000입니다.

새 파일 업로드

1. 업로드 예약

아래 예시는 image.jpg가 정확히 1,048,576바이트인 경우입니다. fileSize는 실제 파일 크기로 바꾸세요.

curl --request POST "https://www.posteady.com/api/v1/media/uploads" \
  --header "Authorization: Bearer $POSTEADY_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "mediaType": "IMAGE",
  "fileName": "image.jpg",
  "contentType": "image/jpeg",
  "fileSize": 1048576
}'

응답의 mediaId·fileKey·uploadUrl·expiresInSeconds·requiredHeaders를 저장하세요. 예약만으로 파일이 발행 가능한 상태가 되지는 않습니다.

2. 파일 바이트 전송

uploadUrl을 실제 반환값으로 바꾸고 300초 안에 PUT하세요. 다음 헤더는 위 파일 크기의 예시입니다. 응답의 requiredHeaders 값을 모두 그대로 사용하세요. 이 저장소 요청에는 Posteady Bearer 키를 보내지 않습니다.

curl --request PUT "<uploadUrl>" \
  --header "Content-Type: image/jpeg" \
  --header "Content-Length: 1048576" \
  --upload-file image.jpg

3. 완료 확인

PUT 성공 후 업로드 생성 시점부터 24시간 안에 반환된 fileKey로 완료를 확인하세요. 예약한 사용자와 워크스페이스를 그대로 사용해야 합니다.

curl --request POST "https://www.posteady.com/api/v1/media/uploads/confirm" \
  --header "Authorization: Bearer $POSTEADY_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "fileKey": "<fileKey>"
}'

완료 확인 응답의 mediaId를 발행 요청에 사용하세요. 이미지·영상 형식과 예약된 크기를 검증한 뒤에만 라이브러리에 등록됩니다. 영상의 duration·width·height는 선택적인 참고값이며 지원되는 MP4·QuickTime의 실제 값은 서버가 측정합니다.

형식과 한도

파일	`mediaType`	`contentType`	최대 크기
JPEG	`IMAGE`	`image/jpeg`	8 MiB
MP4	`VIDEO`	`video/mp4`	2 GiB
QuickTime	`VIDEO`	`video/quicktime`	2 GiB

파일명은 255자 이내이며 경로·제어문자를 포함하면 안 됩니다. JPEG는 .jpg/.jpeg/.jfif, 영상은 .mp4/.mov 확장자를 사용하세요. 업로드 예약 용량도 조직 저장 공간 한도에 포함됩니다. 파일은 완료 확인 전까지 비공개 보관되며 만료된 미확인 업로드는 정리됩니다. 확인되지 않은 ID로 발행할 수 없습니다. 공용 라이브러리의 업로드 한도와 플랫폼별 발행 한도는 다릅니다.

플랫폼별 형식 확인 · 업로드 레퍼런스 · 완료 확인 레퍼런스

미디어 업로드