API Overview

DigiWedge Tee Time API for developers and integrators.

Introduction

The Tee Time API provides programmatic access to:

• Tee time search and booking
• Player management
• Tournament operations
• Course information

Base URL

Production: https://api.digiwedge.com/teetime/v1
Staging:    https://api.uat.digiwedge.com/teetime/v1

Authentication

All API requests require authentication via Bearer token.

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://api.digiwedge.com/teetime/v1/courses

See Authentication for details on obtaining tokens.

Quick Start

Search for Tee Times

GET /courses/{courseId}/tee-times/visitor?date=2025-01-15

Response:

{
  "teeTimes": [
    {
      "time": "08:00",
      "available": 4,
      "price": 450,
      "currency": "ZAR"
    }
  ]
}

Make a Booking

POST /bookings
{
  "courseId": "championship-course",
  "teeTime": "2025-01-15T08:00:00Z",
  "players": 4,
  "playerDetails": [
    { "name": "John Smith", "email": "john@example.com" }
  ]
}

Available Endpoints

Courses

Method	Endpoint	Description
GET	/courses	List all courses
GET	/courses/{id}	Get course details
GET	/courses/{id}/tee-times/visitor	Visitor tee times
GET	/courses/{id}/tee-times/member	Member tee times

Bookings

Method	Endpoint	Description
POST	/bookings	Create booking
GET	/bookings/{id}	Get booking
PUT	/bookings/{id}	Update booking
DELETE	/bookings/{id}	Cancel booking

Players

Method	Endpoint	Description
GET	/players/me	Current player
GET	/players/me/bookings	Player bookings
GET	/players/me/buddies	Player buddies

Tournaments

Method	Endpoint	Description
GET	/tournaments	List tournaments
GET	/tournaments/{id}	Tournament details
POST	/tournaments/{id}/entries	Enter tournament

Response Format

All responses are JSON with consistent structure:

Success Response

{
  "data": { ... },
  "meta": {
    "timestamp": "2025-01-15T12:00:00Z",
    "requestId": "req_123abc"
  }
}

Error Response

{
  "error": {
    "code": "BOOKING_NOT_FOUND",
    "message": "Booking with ID xyz not found",
    "details": { ... }
  },
  "meta": {
    "timestamp": "2025-01-15T12:00:00Z",
    "requestId": "req_123abc"
  }
}

Rate Limits

Tier	Requests/minute	Burst
Standard	60	100
Premium	300	500
Enterprise	Custom	Custom

Rate limit headers included in responses:

• X-RateLimit-Limit
• X-RateLimit-Remaining
• X-RateLimit-Reset

SDKs & Libraries

Official client libraries:

• JavaScript/TypeScript: @digiwedge/teetime-api-client
• Python: Coming soon
• PHP: Coming soon

Support

• API Documentation: This site
• Swagger/OpenAPI: https://api.digiwedge.com/teetime/docs
• Support: api-support@digiwedge.com