Troubleshooting a callback server

Check the following if transcription requests are successful and responding with a success code, requestid , and your callback server is not receiving results:

  • Verify that external hosts can reach your callback server. Receiving a success code and requestid in response to a POST request to the /transcribe endpoint shows that the system making the request can reach V‑Cloud. However, this does not mean V‑Cloud can reach your callback host.

    To test connectivity between V‑Cloud and your callback server, log in on a host that is not on your local network and can be reached directly from the internet. Try to reach the host on which your callback server is running using a request similar to the following:

    curl -i https://hostname:port/endpoint

    The host and port that you specify are the host and port on which your callback server is listening. The -i option tells the curl command to display the HTTP header that it receives. For example, if you are using the sample callback server, you would receive a response similar to the following:

    HTTP/1.1 200 OK
    Note: If your network administration policies restrict inbound connectivity from external hosts, contact support@vocitec.com for the list of V‑Cloud IP addresses that need access.
  • Identify problems in your callback server. If you are able to reach the host and port of your callback server, connectivity is not the problem. Try the following steps to identify problems with your callback server:

    • Verify that you send a POST request directly to your callback server. The following request simulates the data that would be sent by V‑Cloud to your callback server:

      curl -F "file=@test.zip;type=application/zip" \ -F requestid=700e7496-4fce-4963-aa7b-b3b26600f813 \ https://hostname:port/endpoint

      The request provides the two fields of the multipart POST that your callback server needs to handle. Make sure that your callback server returns success (HTTP code 200) when these two fields are received.

    • Verify correct error handling. It is possible that V‑Cloud encountered an error. In such cases, a message will post in an error field to your callback server. The callback server must be able to handle receiving error messages from V‑Cloud. The following request simulates the data that would be sent by V‑Cloud to your callback server in the case of an error:

      curl -F "error=This is a sample error" \ -F requestid=700e7496-4fce-4963-aa7b-b3b26600f813 \ https://hostname:port/endpoint

    If you still cannot identify or resolve the problem with your callback server, contact support@vocitec.com for assistance.