1. User Guide
  2. Using the Oracle Hospitality APIs
  3. Oracle Hospitality Asynchronous APIs
  4. Workflow
  5. Best Practices

Best Practices

  • Asynchronous APIs allow a maximum of 150 requests per minute for each application, encompassing POST, HEAD, and GET requests. Take this into account when deciding the polling frequency for HEAD requests.

  • After sending a POST request, allow a waiting period of at least 1-2 minutes before initiating the HEAD request.

  • When sending a HEAD request, wait for the HTTP status 201 Created response before proceeding with the GET request.

  • If the HEAD request gives an HTTP Status 200 OK response, allow another 1-2 minutes before resending the HEAD request. In other words, if the HEAD response does not return a 201 Created response with a header location, the job probably has not finished yet. Allow another 1-2 minutes before sending the GET request. After receiving an HTTP status 201 Created, you can proceed with the GET request.

  • Remember that multiple retries of the HEAD call might be necessary, depending on the volume of data being returned. 

Parent topic: Workflow