Introduction

This document contains instructions for working with the channel manager API and describes how one can :

  • List countries with golf courses available for booking
  • List golf courses in a specific country
  • List available tee times of a golf course
  • Book a tee time with a golf course
  • Cancel a booking with a golf course

Audience

This document is intended for application developers that want to interface with the Channel Manager programmatically by using the Zest restful json api’s. Users that are looking for a more lightweight integration with the channel manager that requires little to no software development effort are encouraged to use the channel manager’s web-based booking interface.

Authorization

This API expects credentials to be supplied via HTTP Basic Authentication. API requests without authentication information will fail. Contact development@zest.golf to request access to the system.

Transport Layer Security

All API requests must be made over HTTPS. Calls made over plain HTTP will fail.

Base Url

To obtain the base url, select the appropriate environment from below list and append /api/v1 to it (e.g. https://sandbox-cm.zest.golf/api/v1) :

Content type

This API is organized around REST and is designed to use HTTP response codes to indicate API errors. All API responses, including errors are returned in JSON format.

Versioning

Currently our API contains three versions (v1,v2 and v3).

HTTP Status Code Summary

  • 200 Successful Response Everything worked as expected.
  • 400 Bad Request One of the required parameters is missing or given in a wrong format.
  • 401 Unauthorized Credentials are either not present of invalid.
  • 404 Not Found The requested resource does not exist.
  • 500 Internal Server Error Please try again later. Contact development@zest.golf if the problem persists.