Main API
영상 변환 알림 API
MediaConvert 영상 변환 완료 알림 수신 API
영상 변환 알림 API
AWS MediaConvert 영상 변환 완료 시 알림을 수신하는 웹훅 API입니다.
이 API는 AWS 서비스가 호출하는 웹훅입니다. 직접 호출하지 마세요.
인증 정보
| 항목 | 값 |
|---|---|
| 인증 필요 | 아니오 (웹훅) |
| 인증 방식 | - |
엔드포인트 목록
| 메서드 | 경로 | 설명 | 인증 |
|---|---|---|---|
POST | /mediaConvert | 미디어 변환 상태 수신 | 불필요 |
API 상세
미디어 변환 상태 수신
AWS MediaConvert에서 영상 변환이 완료되면 상태값을 수신하고 Firebase 푸시 알림을 전송합니다.
HTTP 요청
POST /mediaConvert
Content-Type: application/jsonRequest Body
{
"assetID": "video-asset-12345",
"mediaConvertStatus": "COMPLETE",
"serverType": "production"
}Request Body 스키마 (MediaConvertStatusUpdateRequest)
| 필드명 | 타입 | 필수 | 설명 |
|---|---|---|---|
assetID | string | 예 | 변환된 영상 에셋 ID |
mediaConvertStatus | string | 예 | 변환 상태 |
serverType | string | 아니오 | 서버 타입 |
응답
성공 응답 (200 OK)
OK변환 상태
| 상태 | 설명 |
|---|---|
SUBMITTED | 변환 작업 제출됨 |
PROGRESSING | 변환 진행 중 |
COMPLETE | 변환 완료 |
ERROR | 변환 오류 |
CANCELED | 변환 취소됨 |
처리 흐름
1. 사용자 → 영상 업로드 → S3
2. S3 → AWS MediaConvert (영상 변환 시작)
3. MediaConvert → 변환 완료
4. AWS EventBridge/Lambda → POST /mediaConvert
5. Spring 서버 → Firebase 푸시 알림 전송
6. 사용자 앱 → 알림 수신연동 설정
이 웹훅은 AWS EventBridge 또는 Lambda에서 MediaConvert 이벤트 발생 시 자동으로 호출되도록 설정되어야 합니다.
AWS 설정 예시
- MediaConvert Job 완료 이벤트 발생
- EventBridge Rule이 이벤트 감지
- Lambda 함수 트리거
- Lambda가
/mediaConvert엔드포인트 호출