Overview

Element

Effect

Notifications Webhook

Configure une URL de webhook pour recevoir automatiquement un appel de retour POST lorsque le rendu se termine (succès ou échec). Vous pouvez définir l'URL dans la Console de Rendu ou de manière programmatique.

Définir ou Mettre à Jour l'URL du Webhook

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

Déclencher une Livraison de Test

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

Charge Utile du 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"
}
  • L'appel de retour est une requête JSON POST envoyée immédiatement après la fin du rendu.
  • Répondez dans les 5 secondes ; les délais d'attente ne sont pas réessayés.
  • Utilisez le champ status (success ou failed) avec error_message/error_log_url pour gérer les échecs de manière élégante.