Table of Contents

Loading ...

REST API Troubleshooting

Here is a list of common problems you can encounter with Wazo REST APIs.

Swagger UI: Can't read from server...

Problem

When trying to access Swagger UI via http://wazo/api, I get:

Can't read from server. It may not have the appropriate access-control-origin settings.

Answer

This is a very generic error message from Swagger UI. It can have a variety of causes, most commonly:

  • the HTTPS certificate of the API you're trying to get is not trusted
  • the daemon that serves the API is not running

What you can do:

  • check that the Swagger API spec is accessible: when choosing an API in the Swagger menu, copy-paste the URL of the top text box ending with api.yml into your browser.
  • check the HTTP requests/answers in your browser debugging tools
  • check that the daemon is running: in a console, type: wazo-service status
  • check the log files of the daemon in /var/log/<daemon>.log (see also: Log Files)