Webhooks · Notification de fin de lot

    Vos lots terminés, signalés à votre application

    Dès qu'un lot de classement est terminé, votre serveur reçoit un message JSON signé : identifiant du lot, nombres d'articles et d'erreurs, date de fin et, pour les lots API, l'URL des résultats. Vous n'interrogez plus l'API en boucle : vous récupérez les résultats au bon moment.

    Notification à la fin du lot
    Jusqu'à 3 tentatives
    JSON {event, data, timestamp}
    Signature HMAC-SHA256
    CrossbordIA — Journal des webhooks
    bulk.completed200 OK
    { "event": "bulk.completed", "data": { "job_id": "j_8f3k", "total": 24, "errors": 1 } }
    142ms14:32:18
    bulk.api.completed200 OK
    { "event": "bulk.api.completed", "data": { "job_id": "j_m7p1", "total": 12, "failed": 0 } }
    89ms13:45:02
    bulk.completed502
    { "event": "bulk.completed", "data": { "job_id": "j_q2w9", "total": 18, "errors": 0 } } → tentative 1/3
    3012ms12:30:10
    bulk.completed200 OK
    { "event": "bulk.completed", "data": { "job_id": "j_q2w9", "total": 18, "errors": 0 } } → tentative 2/3 ✓
    155ms12:30:14
    3
    Tentatives de livraison
    10 s
    Délai de réponse par tentative
    HMAC
    Signature SHA-256
    JSON
    Enveloppe {event, data, timestamp}
    Fonctionnalités

    Des notifications fiables et vérifiables

    Votre système sait quand un lot est prêt et peut prouver que le message vient bien de CrossbordIA.

    Lots

    Fin de lot

    bulk.completed pour les lots lancés depuis l'application (identifiant, nom du lot, nombre d'articles, erreurs, date de fin) ; bulk.api.completed pour les lots API, avec l'URL des résultats.

    Standard

    JSON stable

    Chaque envoi suit le même format : { event, data, timestamp }. L'en-tête X-Webhook-Event indique l'événement.

    Fiabilité

    Jusqu'à 3 tentatives

    Envoi immédiat, puis nouvelles tentatives à +1 s et +4 s si votre serveur répond 5xx, ne répond pas en 10 s ou est injoignable. Une réponse 4xx arrête les tentatives.

    Sécurité

    Signature HMAC-SHA256

    Chaque URL a son secret (whsec_…), affiché une seule fois. Recalculez le HMAC-SHA256 du corps reçu et comparez-le à l'en-tête X-Webhook-Signature.

    Suivi

    Journal par URL

    Pour chaque tentative : date, événement, numéro de tentative, statut HTTP, latence et résultat. Menu du compte > Webhooks.

    Flexibilité

    Plusieurs URL

    Ajoutez plusieurs URL HTTPS, activez ou désactivez chacune séparément ; chacune reçoit les deux événements.

    Intégration

    Branchez vos webhooks en 4 étapes

    Quelques minutes de configuration, puis une notification à chaque lot terminé.

    01

    Ajouter l'URL

    Menu du compte > Webhooks : saisissez une URL HTTPS. Un secret est généré.

    02

    Copier le secret

    Il ne s'affiche qu'une fois. Utilisez-le côté serveur pour vérifier X-Webhook-Signature.

    03

    Recevoir la notification

    À chaque lot terminé, votre serveur reçoit un POST JSON {event, data, timestamp}.

    04

    Répondre 2xx

    Une réponse 2xx confirme la réception. En cas de 5xx ou sans réponse sous 10 s, deux nouvelles tentatives suivent (+1 s, +4 s).

    Prêt à automatiser ?

    Soyez prévenu à la fin de chaque lot

    Vos systèmes reçoivent une notification signée dès qu'un lot est terminé, puis récupèrent les codes justifiés et les questions en attente au bon moment.

    HMAC-SHA256 · 3 tentatives · 10 crédits offerts à l'essai