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
requestidin response to a
POSTrequest to the
/transcribeendpoint 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
curlcommand 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 OKNote: If your network administration policies restrict inbound connectivity from external hosts, contact firstname.lastname@example.org 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
POSTrequest directly to your callback server. The following request simulates the data that would be sent by V‑Cloud to your callback server:
curl -F "email@example.com;type=application/zip" \ -F requestid=700e7496-4fce-4963-aa7b-b3b26600f813 \ https://hostname:port/endpoint
The request provides the two fields of the multipart
POSTthat 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 firstname.lastname@example.org for assistance.