Gestion
Créer un endpoint de webhook
Nécessite un Management Token d'espace de travail (mt-...), créé dans Dashboard > API > Management Tokens. Envoyez Authorization: Bearer mt-.... Les clés d'API d'inférence (sk-...) et les secrets de signature de webhook (whsec_...) ne sont pas acceptés. Seul l'espace de travail du token est accessible. Le secret de signature complet whsec_ n'est renvoyé qu'à la création ou à la rotation. Stockez-le en toute sécurité ; GET/list ne le renvoient jamais. La rotation prend effet immédiatement pour les nouvelles livraisons ; les livraisons déjà en cours peuvent toujours utiliser le secret précédent. Jusqu'à 10 endpoints par espace de travail. Les abonnements couvrent les futurs événements de tâches asynchrones terminaux ; les tâches existantes ne sont pas rejouées.
Utilisez un Management Token (mt-...) d'espace de travail, et non une clé API d'inférence (sk-...) ou un secret de signature (whsec_...). Créez-en un via Dashboard → API → Management Tokens et envoyez Authorization: Bearer mt-.... L'accès est limité à cet espace de travail.
Consultez le guide de l'API de gestion des webhooks pour plus d'informations sur les événements, la vérification, les tentatives de renvoi et le dépannage.
curl -X POST "https://example.com/v1/management/webhooks" \ -H "Content-Type: application/json" \ -d '{ "url": "http://example.com", "events": [ "task.completed" ] }'{ "id": "string", "object": "webhook_endpoint", "url": "string", "events": [ "task.completed" ], "is_active": true, "description": "string", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "last_delivered_at": "2019-08-24T14:15:22Z", "failure_count": 0, "secret": "string"}Autorisation
ManagementTokenAuth Authentification par jeton de gestion. Créez ou gérez vos jetons de gestion dans Dashboard > API > Management Tokens.
Emplacement: header
Corps de la requête
application/json
Réponse
application/json
application/json
application/json
application/json
application/json
application/json