API 레퍼런스미디어
업로드 생성
미디어 ID를 예약하고 파일을 전송할 서명된 업로드 URL을 발급받습니다.
curl -X POST "https://example.com/api/v1/media/uploads" \ -H "Content-Type: application/json" \ -d '{ "mediaType": "IMAGE", "fileName": "photo.jpg", "contentType": "image/jpeg", "fileSize": 102400 }'{ "mediaId": "22222222-2222-4222-8222-222222222222", "mediaType": "IMAGE", "fileKey": "api-staging/66666666-6666-4666-8666-666666666666/22222222-2222-4222-8222-222222222222/photo.jpg", "uploadUrl": "https://storage.example.com/upload?signature=example", "expiresInSeconds": 300, "requiredHeaders": { "Content-Type": "image/jpeg", "Content-Length": "102400" }}미디어 ID를 예약하고 비공개 임시 저장소의 서명된 업로드 URL을 발급받습니다. VIDEO는 최대 2 GiB의 MP4/QuickTime, IMAGE는 최대 8 MiB의 JPEG를 허용합니다. mediaType 기본값은 VIDEO입니다. 300초 안에 반환된 requiredHeaders를 모두 사용하여 uploadUrl로 파일 바이트를 PUT한 다음 fileKey로 POST /api/v1/media/uploads/confirm을 호출하세요. 이 요청만으로는 파일이 업로드되지 않으며 예약된 mediaId를 아직 발행에 사용할 수 없습니다. 생성 후 24시간 안에 업로드를 확인하세요. 예약 파일 크기는 조직의 미디어 저장 용량에 포함되며 만료된 미확인 업로드는 정리됩니다. 워크스페이스는 API 키로 결정됩니다.
인증
apiKey 인증Bearer <token>
위치: header
요청 본문
application/json
TypeScript 타입
TypeScript에서 request body 타입을 사용하세요.
응답 본문
application/json
application/json
application/json