Внутренняя ошибка портала разработчика

Вы просматриваете документацию Apigee Edge .
Перейдите в документацию Apigee X.info

Симптом

Ошибка возникла при выполнении запроса к API в режиме реального времени с использованием SmartDocs через портал разработчика.

Сообщения об ошибках

Наиболее распространённая ошибка на портале разработчиков — « Произошла внутренняя ошибка. Пожалуйста, повторите запрос ».

Возможные причины

Эта ошибка может возникнуть, когда портал разработчика не получает ответа от бэкэнда (прокси-сервера SmartDocs или фактической конечной точки).

Диагноз

Включите «Инструменты разработчика» в своем браузере и проверьте вкладку «Сеть», чтобы определить фактическую ошибку.

В следующей таблице перечислены распространенные ошибки и их типичные причины:

Давайте рассмотрим каждую из этих причин по отдельности и шаги по решению проблемы.

Неправильная настройка прокси-сервера SmartDocs или ограничения сетевого брандмауэра.

Сообщение « ERR_NAME_NOT_RESOLVED » указывает на то, что URL-адрес прокси-сервера SmartDocs настроен неправильно или сеть, из которой осуществляется доступ к порталу, не может выполнить вызов к URL-адресу прокси-сервера SmartDocs из-за ограничений брандмауэра. Прокси-сервер SmartDocs должен быть доступен из интернета или из внутренней сети (для внутренних API).

Разрешение

Убедитесь, что прокси-сервер SmartDocs доступен из всех необходимых сетей, развернув его на виртуальном хосте в Edge с именем хоста, доступным из интернета.

Портал настроен по протоколу HTTPS, запросы SmartDocs обрабатываются по протоколу HTTP.

Ошибка « Смешанное содержимое » указывает на то, что прокси-сервер SmartDocs вызывается по протоколу HTTP со страницы, загруженной по протоколу HTTPS.

Разрешение

Для решения проблемы используйте прокси-сервер SmartDocs через HTTPS. Это можно сделать, развернув прокси-сервер SmartDocs с виртуальным хостом , настроенным на использование TLS/SSL (обычно это «защищенный» виртуальный хост).

Прокси SmartDocs возвращает исключение.

Ошибка 500 — Internal Server Error — может быть вызвана проблемой с прокси-сервером «smartdocs». ​​В этом случае вы заметите, что прокси-сервер smartdocs возвращает эту ошибку.

Диагноз

Для диагностики ошибок, связанных с прокси-сервером «smartdocs», используйте инструмент «Трассировка», как описано ниже. Дополнительную информацию см. в разделе «Использование инструмента «Трассировка» ».

1. Включите трассировку для прокси-сервера « smartdocs » в организации « VALIDATE », чтобы определить конкретную политику, которая возвращает ошибку 500 Internal Server Error.

2. Выберите конкретную политику в трассировке, чтобы определить причину ошибки.

Разрешение

Устраните выявленную ошибку. Если вам потребуется помощь, обратитесь в службу поддержки Apigee Edge .

Обработчики сообщений на границе сети не могут вызвать опубликованную конечную точку API.

Ошибка 500 — Внутренняя ошибка сервера — также может возникнуть, когда обработчики сообщений, принадлежащие организации, на которой размещен прокси-сервер Smartdocs, не могут вызвать конечную точку API.

Диагноз

Для диагностики ошибок, связанных с прокси-сервером «smartdocs», используйте инструмент «Трассировка», как описано ниже. Дополнительную информацию см. в разделе «Использование инструмента «Трассировка» ».

1. Включите трассировку для прокси-сервера « smartdocs » в организации « VALIDATE », чтобы определить конкретную политику, которая возвращает ошибку 500 Internal Server Error.

2. В приведенном выше примере трассировки пользовательского интерфейса видно, что политика JavaScript « BuildTargetAPIRequest » не выполняет целевой URL-адрес.

3. Получите целевой URL-адрес из политики JavaScript « BuildTargetAPIRequest ».

4. Выполните прямой вызов URL-адреса с узлов обработки сообщений, связанных с организацией « VALIDATE », как показано ниже:

   curl -v <target URL>

5. Исправьте все обнаруженные ошибки.

Разрешение

1. Убедитесь, что API, опубликованные на портале разработчиков, могут быть вызваны из обработчиков сообщений, связанных с организацией « VALIDATE », и исправьте все обнаруженные ошибки.

2. Если вы можете выполнить вызов API непосредственно из обработчика сообщений, весьма вероятно, что вы сможете выполнить вызов API и через SmartDocs.

3. Выполните вызов API через SmartDocs и проверьте, устранена ли проблема.