General troubleshooting with the Swagger Editor

General troubleshooting with the Swagger Editor

Swagger Editor TypeError:NetworkError when attempting to fetch a resource

zosConnect-3.0 Applies to zosConnect-3.0.

Containers Applies to z/OS Connect container deployments.

When you test your IBM® z/OS® Connect API with the built-in Swagger Editor, select the port that matches your web browser port.

If the ports don't match, then the TypeError:NetworkError when attempting to fetch resource error is displayed trying to run the API Project.

Procedure
  1. If you use port 9443 to view the IBM z/OS Connect Designer, then select https://localhost:9443/ from the menu.
  2. If you use port 9080 to view the IBM z/OS Connect Designer, then select https://localhost:9080/ from the menu.

If you use port 9080 to view the IBM z/OS Connect Designer, then select https://localhost:9080/ from the menu.

Swagger Editor No operations defined in spec

zosConnect-3.0 Applies to zosConnect-3.0.

Containers Applies to z/OS Connect container deployments.

When you start the Swagger Editor to test your API Project for the first time, you might be presented with a blank Swagger UI for 60 - 90 seconds. This is the Swagger application building and deploying your API Project ready for testing.

Procedure
  1. Check the container logs to verify the status of the API Project and see whether it's ready for testing. For more information, see Viewing IBM z/OS Connect Designer container logs in Docker.
  2. If you see No operations defined in spec in the Swagger Editor, the project is not yet ready for testing. Refresh the Swagger Editor to reload the page for testing.