Erreur interne du portail des développeurs

<ph type="x-smartling-placeholder"></ph> Vous consultez la documentation Apigee Edge.
Accédez à la page Documentation sur Apigee X. En savoir plus

Symptôme

Une erreur s'est produite lors de l'envoi d'une requête API en direct à l'aide de SmartDocs du développeur portail.

Messages d'erreur

L'erreur courante observée sur le portail des développeurs est "Une erreur interne s'est produite. Veuillez relancer votre demande".

Causes possibles :

Cette erreur peut se produire lorsque le portail des développeurs ne parvient pas à obtenir de réponse du backend (Smartdocs proxy ou le point de terminaison réel).

Diagnostic

<ph type="x-smartling-placeholder"></ph> Activez "Outils pour les développeurs" dans votre navigateur et consultez l'onglet "Réseau" pour identifier l'erreur réelle.

Les erreurs courantes et leurs causes courantes sont listées dans le tableau suivant:

Erreur

Cause(s) type

ERR_NAME_NOT_RESOLVED

Proxy SmartDocs mal configuré ou pare-feu réseau restrictions

Contenu mixte

Portail configuré via HTTPS, requête SmartDocs via HTTP

500 – Erreur de serveur interne

Passons en revue chacune de ces causes et les étapes à suivre pour résoudre le problème.

Proxy SmartDocs mal configuré ou pare-feu réseau restrictions

Le message ERR_NAME_NOT_RESOLVED indique que l'URL de proxy smartdocs est mal configurée ou le réseau à partir duquel le portail est accessible impossible d'appeler l'URL du proxy smartdocs en raison de restrictions du pare-feu. Smartdocs doit être accessible depuis Internet ou depuis le réseau interne (pour les API internes).

Solution

Assurez-vous que le proxy smartdocs est accessible depuis tous les réseaux requis en déployant le proxy smartdocs vers un hôte virtuel sur Edge avec un nom d'hôte qui est accessibles depuis Internet.

Portail configuré via HTTPS, requête SmartDocs via HTTP

L'erreur Contenu mixte indique que le proxy smartdocs est appelés via HTTP à partir d'une page chargée via HTTPS.

Solution

Exposez le proxy Smartdocs via HTTPS pour résoudre le problème. Pour ce faire, déployez Smartdocs pour inclure un hôte virtuel configuré pour utiliser TLS/SSL (généralement l'hôte virtuel "sécurisé").

Le proxy SmartDocs renvoie une exception

Le message 500 - Erreur interne du serveur peut être dû à un problème de via le proxy "smartdocs". Dans ce cas, vous remarquez que le proxy smartdocs renvoie ce .

Diagnostic

Utilisez l'outil Trace pour diagnostiquer les erreurs avec le proxy "smartdocs", comme décrit ci-dessus. ci-dessous. Pour en savoir plus, consultez Utiliser l'outil Trace.

  1. Activez la trace pour le proxy smartdocs dans l'organisation "VALIDATE" pour localiser la règle spécifique qui est renvoyant l'erreur interne 500 du serveur.

  1. Sélectionnez la règle spécifique dans la trace pour identifier la cause de l'erreur.

Solution

Corrigez l'erreur identifiée. Si vous avez besoin d'aide, contactez l'assistance Apigee Edge.

Les processeurs de messages Edge ne peuvent pas appeler le point de terminaison de l'API publié

500 : une erreur interne du serveur peut également se produire lorsque les processeurs de messages appartenant au L'organisation hébergeant le proxy Smartdocs ne parvient pas à appeler le point de terminaison de l'API.

Diagnostic

Utilisez l'outil Trace pour diagnostiquer les erreurs avec le proxy "smartdocs", comme décrit ci-dessus. ci-dessous. Pour en savoir plus, consultez Utiliser l'outil Trace.

  1. Activez la trace pour le document smartdocs. dans l'organisation "VALIDATE" pour localiser la règle spécifique qui renvoie l'erreur interne 500 du serveur.

  1. Dans l'exemple de trace d'interface utilisateur présenté ci-dessus, on constate que la stratégie JavaScript "BuildTargetAPIRequest" ne parvient pas à exécuter l'URL cible.
  1. Obtenir l'URL cible à partir de la stratégie JavaScript "BuildTargetAPIRequest".
  1. Effectuez un appel direct à l'URL à partir des nœuds du processeur de messages associés à "VALIDATE" comme indiqué ci-dessous: 
    curl -v <target URL>
  1. Corrigez les erreurs observées.

Solution

  1. Assurez-vous que les API publiées sur le portail des développeurs peuvent être appelées depuis des processeurs de messages associée à l'organisation "VALIDATE" et corrigez les éventuelles erreurs rencontrés.
  1. Si vous êtes en mesure d'exécuter l'appel d'API directement à partir du processeur de messages, il s'agit il est très probable que vous soyez également en mesure d'exécuter l'API via SmartDocs.
  1. Exécutez l'appel d'API via SmartDocs et vérifiez si le problème est résolu.