DOMBO HOSTLY API Documentatie

Authenticatie

De DOMBO HOSTLY API gebruikt API keys voor authenticatie. Voeg je API key toe aan de X-API-Key header of als api_key query parameter.

API Key verkrijgen

Voorbeeld

curl -H "X-API-Key: dombo_1234567890abcdef..." \
     https://hostly.dombo.ai/api/v1/tenant
                        

API Endpoints

API Informatie

GET /v1

Haal API informatie en beschikbare endpoints op

curl -H "X-API-Key: dombo_WL8RxHfza5ZzVpyZa9xC3811VU4nETt0cbUil7oH" \
     https://hostly.dombo.ai/api/v1
                            

Tenant Informatie

GET /v1/tenant

Haal tenant informatie op

Locaties

GET /v1/locations

Lijst van alle locaties

GET /v1/locations/{id}

Specifieke locatie details

Reserveringen

GET /v1/reservations

Lijst van reserveringen (met filters)

GET /v1/reservations/{id}

Specifieke reservering details

POST /v1/reservations

Nieuwe reservering aanmaken

PATCH /v1/reservations/{id}/status

Reservering status bijwerken

Beschikbaarheid

GET /v1/availability

Beschikbare tijdslots voor een locatie

Analytics

GET /v1/analytics

Analytics data en statistieken

GET /v1/stats

Dashboardcijfers per dag: aantal reserveringen, gasten en tafelbezetting per periode (ontbijt, koffie, lunch, borrel, diner). Geschikt voor integratie met o.a. Dyflexis (personeelsplanning).

Query: date=Y-m-d (optioneel, standaard vandaag), location_id= (optioneel, filter op locatie).

Voorbeelden

Nieuwe Reservering Aanmaken

Voorbeeld met Pizzeria Bella Vista (Demo Pizza):

curl -X POST https://hostly.dombo.ai/api/v1/reservations \
  -H "X-API-Key: dombo_WL8RxHfza5ZzVpyZa9xC3811VU4nETt0cbUil7oH" \
  -H "Content-Type: application/json" \
  -d '{
    "location_id": 1,
    "date": "2026-01-15",
    "time": "19:00",
    "party_size": 4,
    "customer_name": "Jan de Vries",
    "customer_email": "jan@example.com",
    "customer_phone": "+31612345678",
    "arrangement_id": 1,
    "notes": "Verjaardag diner"
  }'
                        

Voor Le Bistro (Demo Bistro), gebruik: dombo_71BMdUlcFpjO0Jn2e98oI8BK8rO1Cbca2snx3u6s

Let op: Gebruik date (Y-m-d) en time (H:i) in plaats van start (date-time).

Reserveringen Ophalen met Filters

Voorbeeld met Pizzeria Bella Vista:

curl -H "X-API-Key: dombo_WL8RxHfza5ZzVpyZa9xC3811VU4nETt0cbUil7oH" \
     "https://hostly.dombo.ai/api/v1/reservations?status=confirmed&date_from=2026-01-01&date_to=2026-01-31"
                        

Beschikbaarheid Controleren

Voorbeeld met Le Bistro:

curl -H "X-API-Key: dombo_71BMdUlcFpjO0Jn2e98oI8BK8rO1Cbca2snx3u6s" \
     "https://hostly.dombo.ai/api/v1/availability?location_id=1&date=2026-01-15&party_size=4"
                        

Locaties Ophalen

Haal alle locaties op voor een tenant:

curl -H "X-API-Key: dombo_WL8RxHfza5ZzVpyZa9xC3811VU4nETt0cbUil7oH" \
     "https://hostly.dombo.ai/api/v1/locations"
                        

Error Handling

De API gebruikt standaard HTTP status codes en retourneert errors in JSON formaat.

400 Bad Request

{
  "error": "Validation failed",
  "errors": {
    "email": ["The email field is required."]
  }
}
                                

401 Unauthorized

{
  "error": "Invalid API key",
  "message": "The provided API key is invalid or expired"
}
                                

404 Not Found

{
  "error": "Reservation not found"
}
                                

Rate Limiting

De API heeft rate limiting om misbruik te voorkomen. Standaard limiet is 1000 requests per uur per API key.

Rate limit headers worden geretourneerd in elke response:

X-RateLimit-Limit - Maximum requests per uur
X-RateLimit-Remaining - Resterende requests deze uur
X-RateLimit-Reset - Timestamp wanneer de limiet reset