API 레퍼런스미디어
미디어 조회
워크스페이스 라이브러리에서 업로드가 확인된 이미지와 동영상을 찾습니다.
curl -X GET "https://example.com/api/v1/media?mediaType=IMAGE&limit=20&offset=0"{ "media": [ { "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" } ], "total": 1, "hasMore": false}API 키의 워크스페이스 라이브러리에서 지원되는 활성 미디어를 조회합니다. 하위 호환을 위해 mediaType 기본값은 VIDEO이며 JPEG는 IMAGE를 지정하세요. 지원되는 발행·예약 요청에 mediaId를 사용할 수 있습니다. 확인되지 않은 업로드는 제외됩니다. 계정과 미디어는 같은 워크스페이스에 있어야 합니다.
인증
apiKey 인증Bearer <token>
위치: header
쿼리 매개변수
mediaType?string
기본값
"VIDEO"허용값
- "IMAGE"
- "VIDEO"
limit?integer
범위
1 <= value <= 100기본값
20offset?integer
범위
0 <= value <= 10000기본값
0응답 본문
application/json
application/json