Résolution des problèmes liés aux demandes de webhook et de contenu connecté

Cet article explique comment dépanner les codes d’erreur courants pour les webhooks et le contenu connecté, et fournit des explications supplémentaires sur la façon dont ces erreurs peuvent se produire dans vos demandes.

Erreurs 4XX

4XX indiquent qu’il y a un problème avec la requête envoyée à l’endpoint. Ces erreurs sont généralement causées par des demandes erronées, notamment des paramètres mal formés, des en-têtes d’authentification manquants ou des URL incorrectes.

Reportez-vous au tableau suivant pour connaître les détails du code d’erreur et les étapes de résolution :

code d'erreur	Ce que cela signifie	Marche à suivre pour résoudre le problème
400 Demande erronée	La syntaxe de la demande n'est pas correcte.	Vérifiez que les données utiles de la demande ne comportent pas d'erreurs de syntaxe. Confirmez que tous les champs obligatoires sont inclus et correctement formatés. Si vous envoyez une charge utile JSON, validez la structure JSON.
401 Non autorisé	La demande nécessite l'authentification de l'utilisateur.	Vérifiez que les informations d'authentification correctes (telles que les clés ou jetons API) sont incluses dans les en-têtes de la demande. Confirmez que vous disposez des autorisations d'utilisateur pour accéder à l'endpoint.
403 Interdit	L'endpoint comprend la demande mais refuse de l'autoriser.	Vérifiez si la clé ou le jeton API dispose des autorisations requises. Confirmez que vous disposez des autorisations d'utilisateur pour accéder à l'endpoint.
404 Page introuvable	L'endpoint ne trouve pas la ressource demandée.	Vérifiez que l'URL de l'endpoint ne contient pas de fautes de frappe ou de chemins d'accès incorrects. Confirmez que la ressource à laquelle vous essayez d'accéder existe.
405 Méthode non autorisée	La méthode de demande est connue par l'endpoint mais n'est pas prise en charge par la ressource cible.	Vérifiez la méthode HTTP (DELETE, GET, POST, PUT) utilisée dans la requête. Confirmez que l'endpoint prend en charge la méthode que vous utilisez.
408 Délai de requête	L'endpoint a dépassé le délai de traitement de la demande.	Vérifiez la méthode HTTP (DELETE, GET, POST, PUT) utilisée dans la requête. Confirmez que l'endpoint prend en charge la méthode que vous utilisez.
409 Conflit	La demande est incomplète en raison d'un conflit avec l'état actuel de la ressource.	Vérifiez la méthode HTTP (DELETE, GET, POST, PUT) utilisée dans la requête. Confirmez que l'endpoint prend en charge la méthode que vous utilisez.
429 Trop de demandes	Il y a trop de demandes envoyées dans un laps de temps donné.	Diminuez la limite de débit de votre campagne ou de votre étape du canvas.

Erreurs 5XX

5XX indiquent qu’il y a un problème avec l’endpoint. Ces erreurs sont généralement dues à des problèmes au niveau du serveur.

code d’erreur	Ce que cela signifie
500 Erreur interne du serveur	L’endpoint a rencontré une condition inattendue qui l’a empêché de terminer la demande.
502 Mauvaise passerelle	L’endpoint a reçu une réponse non valide du serveur en amont.
503 Service indisponible	L’endpoint est actuellement incapable de traiter la demande en raison d’une surcharge temporaire ou d’une maintenance.
504 Délai d’attente de la passerelle	L’endpoint n’a pas reçu de réponse en temps voulu de la part du serveur en amont.
599 Erreur de connexion	Braze a rencontré une erreur de délai de connexion au réseau en essayant d’établir une connexion à l’endpoint, ce qui signifie que l’endpoint peut être instable ou en panne.

Résolution des erreurs 5XX

Voici des conseils pour la résolution des problèmes les plus courants sur le site 5XX:

• Consultez le message d’erreur pour obtenir des détails spécifiques disponibles dans le journal d’activité des messages. Pour les webhooks, rendez-vous dans la section Performance au fil du temps sur la page d’accueil de Braze et sélectionnez les statistiques pour les webhooks. À partir de là, vous pouvez trouver l’horodatage qui indique quand les erreurs se sont produites.
• Assurez-vous que vous n’envoyez pas trop de demandes qui surchargent l’endpoint. Vous pouvez envoyer par lots ou ajuster la limite de débit pour vérifier si cela réduit les erreurs.