API 레퍼런스미디어
업로드 확인
업로드한 파일을 검증하여 미디어 ID를 게시물 발행에 사용할 수 있게 합니다.
curl -X POST "https://example.com/api/v1/media/uploads/confirm" \ -H "Content-Type: application/json" \ -d '{ "fileKey": "api-staging/66666666-6666-4666-8666-666666666666/22222222-2222-4222-8222-222222222222/photo.jpg" }'{ "mediaId": "22222222-2222-4222-8222-222222222222", "fileName": "photo.jpg", "mediaType": "IMAGE", "mimeType": "image/jpeg", "fileSize": 102400, "url": "https://media.example.com/photo.jpg", "duration": null, "width": 1080, "height": 1080, "createdAt": "2026-09-07T12:00:00Z"}발급된 URL에 파일을 전송한 뒤 업로드를 확인합니다. Posteady는 저장된 파일의 크기·콘텐츠 유형·파일 시그니처·객체 버전을 예약 정보와 대조한 뒤 비공개 임시 저장소에서 이동합니다. fileKey는 API 키의 워크스페이스에서 예약한 값이어야 하며 24시간 안에 확인해야 합니다. 지원되는 MP4/QuickTime 파일은 Posteady가 길이·가로·세로 크기를 측정합니다. 클라이언트에서 확인한 값이 있으면 함께 보내세요. Instagram 발행은 세 값 중 하나라도 없는 동영상을 거부합니다. 기존 저장 용량 예약을 사용하므로 파일 크기를 중복 계산하지 않습니다. 업로드 확인은 게시물 발행을 실행하지 않습니다.
인증
apiKey 인증Bearer <token>
위치: header
요청 본문
application/json
TypeScript 타입
TypeScript에서 request body 타입을 사용하세요.
응답 본문
application/json
application/json
application/json