웹후크 알림

렌더링이 완료되면(성공 또는 실패) 자동으로 POST 콜백을 수신하기 위해 웹후크 URL을 구성합니다. Render Console에서 또는 프로그래밍 방식으로 URL을 설정할 수 있습니다.

웹후크 URL 설정 또는 업데이트

set-webhook.sh
curl -X POST https://render-api.chillin.online/user/webhook \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"url": "https://your-domain.com/webhook"}'

테스트 전달 트리거

test-webhook.sh
curl -X POST https://render-api.chillin.online/user/webhook/test \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"url": "https://your-domain.com/webhook"}'

웹후크 페이로드

webhook_payload.json
{
"render_id": 123,
"user_id": 456,
"status": "success",
"video_url": "https://cloud.chillin.online/video_xxx.mp4",
"json_url": "https://cloud.chillin.online/project_xxx.json",
"error_message": "",
"error_log_url": "",
"cost": 0.05,
"duration": 10.5,
"finished_at": "2024-01-01T12:00:00Z"
}
  • 콜백은 렌더링이 완료된 직후에 전송되는 JSON POST 요청입니다.
  • 5초 이내에 응답해야 하며, 타임아웃은 재시도되지 않습니다.
  • 실패를 우아하게 처리하기 위해 error_message/error_log_url과 함께 status 필드(success 또는 failed)를 사용하십시오.