Dépannage du relais

Réponse	Cause probable	Solution
401 sans corps	Clé absente, tronquée ou renouvelée	Recopiez la clé en entier ; après un renouvellement, prenez la nouvelle dans App keys, pas dans les sorties du déploiement.
401 : Invalid x-relay-key	En-tête x-relay-key absent ou différent de RELAY_EXTRA_API_KEY	Corrigez l'en-tête dans l'outil.
404 sans corps	Code non installé, faute dans la route (/api/envelope au lieu de /api/enveloppe) ou mauvaise méthode	Reprenez l'étape 5 du déploiement, vérifiez la route et la méthode.
400 : Invalid JSON body	JSON invalide, ou type inattendu : nombre ou booléen entre guillemets, chaîne au lieu d'une liste	Voir Pièges fréquents.
400 avec un autre message	Champ obligatoire absent ou valeur invalide : le message nomme le champ	Corrigez le champ.
500 : Relay is not configured	Identifiant absent, invalide ou nul ; SE_ENDPOINT invalide ; référence Key Vault non résolue (attribution de rôle manquante, coffre injoignable)	Vérifiez les paramètres d'application, l'attribution de rôle sur le coffre, puis redémarrez l'application.
500 : erreur interne	Panne réseau ou exception pendant l'appel	Réessayez ; si l'erreur persiste, consultez les journaux de la Function App.
502	Pas de réponse utilisable de Secure Exchanges, souvent une licence utilisée sur le mauvais environnement	Changez SE_ENDPOINT pour l'autre environnement, puis redémarrez.
403	Secure Exchanges refuse la licence ou la clé d'accès, par exemple sur le mauvais environnement	Vérifiez l'environnement et l'accès API de votre licence ; au besoin, écrivez à supportdev@secure-exchanges.info.
/api/version répond 200, mais /api/enveloppe répond 500 ou 502	/api/version ne vérifie pas la configuration	Traitez l'erreur de /api/enveloppe selon les lignes ci-dessus.
Un destinataire a un status autre que 200	Secure Exchanges l'a refusé, ou le courriel n'a pas pu partir	Vérifiez son adresse ou son numéro. Les autres destinataires ont pu être servis.

Voir les journaux

Le déploiement ne crée pas Application Insights. Pour diagnostiquer une erreur qui persiste, ajoutez-le à la Function App, dans une région adaptée à vos obligations, avec une durée de conservation courte : voir Journaux et renseignements personnels.