Overview

Element

Effect

Webhook-Benachrichtigungen

Konfigurieren Sie eine Webhook-URL, um automatisch eine POST-Rückrufbenachrichtigung zu erhalten, wenn ein Rendern abgeschlossen ist (Erfolg oder Fehler). Sie können die URL in der Render-Konsole oder programmgesteuert festlegen.

Webhook-URL festlegen oder aktualisieren

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"}'

Testlieferung auslösen

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-Nutzlast

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"
}
  • Der Rückruf ist eine JSON POST-Anfrage, die sofort nach Abschluss des Renderns gesendet wird.
  • Antworten Sie innerhalb von 5 Sekunden; Zeitüberschreitungen werden nicht erneut versucht.
  • Verwenden Sie das Feld status (success oder failed) zusammen mit error_message/error_log_url, um Fehler elegant zu behandeln.