<ph type="x-smartling-placeholder"></ph>
현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서. 정보
증상
개발자의 SmartDocs를 사용하여 실시간 API 요청을 할 때 오류가 발생했습니다. 있습니다.
오류 메시지
개발자 포털에 표시되는 일반적인 오류는 '내부 오류가 발생했습니다. 요청을 다시 시도해 주세요.'라는 오류 메시지가 표시됩니다.
가능한 원인
이 오류는 개발자 포털이 백엔드 (smartdocs)로부터 응답을 받지 못하는 경우에 발생할 수 있습니다. 프록시 또는 실제 엔드포인트).
진단
<ph type="x-smartling-placeholder"></ph> 브라우저에서 '개발자 도구'를 사용 설정하고 네트워크 탭에서 실제 오류를 식별할 수 있습니다.
다음 표에는 일반적인 오류와 그 일반적인 원인이 나와 있습니다.
|
오류 |
일반적인 원인 |
|
ERR_NAME_NOT_RESOLVED |
|
|
혼합 콘텐츠 |
|
|
500 - 내부 서버 오류 |
이러한 원인과 문제 해결을 위한 단계를 하나씩 살펴보겠습니다.
SmartDocs 프록시가 잘못 구성되었거나 네트워크 방화벽이 있습니다. 제한
'ERR_NAME_NOT_RESOLVED' 메시지는 smartdocs 프록시 URL이 잘못 구성되었거나 포털에 액세스하는 네트워크가 있습니다. 방화벽 제한으로 인해 smartdocs 프록시 URL을 호출할 수 없습니다. 스마트문서 인터넷이나 내부 네트워크 (내부 API의 경우)에서 액세스할 수 있어야 합니다.
해상도
다음을 배포하여 필요한 모든 네트워크에서 smartdocs 프록시에 액세스할 수 있는지 확인합니다. Edge에서 호스트 이름이 동일한 가상 호스트에 Smartdocs 프록시 인터넷에서 액세스할 수 있어야 합니다.
HTTPS를 통해 구성된 포털, HTTP를 통한 SmartDocs 요청
'혼합 콘텐츠' 오류는 Smartdocs 프록시가 HTTP를 통해 호출되고 있음을 보여줍니다.
해상도
문제를 해결하기 위해 https를 통해 smartdocs 프록시를 노출합니다. 이렇게 하려면 스마트 문서 프록시: TLS/SSL을 사용하도록 구성된 가상 호스트를 포함합니다. (일반적으로 “보안” 가상 호스트)에 있습니다.
SmartDocs 프록시에서 예외가 반환됨
500 - 내부 서버 오류 메시지는 “smartdocs” 프록시가 있습니다. 이 경우, smartdocs 프록시가 다음을 반환한다는 것을 알 수 있습니다. 오류가 발생했습니다.
진단
Trace 도구를 사용하여 'smartdocs' 프록시의 오류를 진단합니다(설명된 대로). 참조하세요. 자세한 내용은 추적 도구 사용을 참조하세요.
- 다음에서 'smartdocs' 프록시의 트레이스 사용 설정 'VALIDATE' 조직을 사용하여 500 내부 서버 오류가 반환됩니다.
- trace에서 특정 정책을 선택하여 오류의 원인을 파악하세요.
해상도
식별된 오류를 수정합니다. 도움이 필요하면 Apigee Edge 지원팀에 문의하세요.
에지 메시지 프로세서가 게시된 API 엔드포인트를 호출할 수 없음
500 - Smartdocs 프록시를 호스팅하는 조직에서 API 엔드포인트를 호출할 수 없습니다.
진단
Trace 도구를 사용하여 'smartdocs' 프록시의 오류를 진단합니다(설명된 대로). 참조하세요. 자세한 내용은 추적 도구 사용을 참조하세요.
- 'smartdocs'에 trace 사용 설정 프록시를 사용하여 특정 정책을 찾습니다. 오류 메시지가 나타납니다.
- 위에 표시된 샘플 UI 트레이스에서 JavaScript 정책이 “BuildTargetAPIRequest”에서 대상 URL을 실행하지 못하고 있습니다.
- JavaScript 정책에서 타겟 URL 가져오기 'BuildTargetAPIRequest'.
- 와 연결된 메시지 프로세서 노드에서 URL을 직접 호출합니다.
'VALIDATE' 조직으로 이동합니다.
<ph type="x-smartling-placeholder">
curl -v <target URL>
</ph>
- 발견된 오류를 모두 수정합니다.
해상도
- 개발자 포털에 게시된 API를 메시지 프로세서에서 호출할 수 있는지 확인하세요. 'VALIDATE' 조직과 관련되어 있고 오류가 있는 경우 수정 발생할 수 있습니다
- 메시지 프로세서에서 직접 API 호출을 실행할 수 있는 경우 SmartDocs를 통해서도 API를 실행할 수 있을 것입니다.
- SmartDocs를 통해 API 호출을 실행하고 문제가 해결되었는지 확인합니다.