Skip to main content

Overview

The Services API provides access to information about various services offered at Zoo Arcadia, including guided tours, restaurants, gift shops, and other visitor facilities.

List All Services

Returns a complete list of all services and facilities available at the zoo.
GET /api/services

Response Fields

success
boolean
Indicates if the request was successful
data
array
Array of service objects
id_service
integer
Unique identifier for the service
service_title
string
Title/name of the service
service_description
string
Detailed description of the service
URL or path related to the service (e.g., booking page)
type
string
Type of service: “featured”, “service”, or “habitat”
media_path
string
URL path to the service’s image (original size)
media_path_medium
string
URL path to the service’s medium-sized image
media_path_large
string
URL path to the service’s large-sized image

Example Request

curl https://zoo-arcadia.example.com/api/services

Example Response

{
  "success": true,
  "data": [
    {
      "id_service": 1,
      "service_title": "Guided Safari Tour",
      "service_description": "Join our expert guides for an unforgettable safari experience through the Savannah habitat.",
      "link": "/tours/safari",
      "type": "featured",
      "media_path": "/uploads/services/safari-tour.jpg",
      "media_path_medium": "/uploads/services/safari-tour-medium.jpg",
      "media_path_large": "/uploads/services/safari-tour-large.jpg"
    },
    {
      "id_service": 2,
      "service_title": "Savannah Restaurant",
      "service_description": "Enjoy delicious meals with a view of the Savannah habitat.",
      "link": "/dining/savannah-restaurant",
      "type": "service",
      "media_path": "/uploads/services/restaurant.jpg",
      "media_path_medium": "/uploads/services/restaurant-medium.jpg",
      "media_path_large": "/uploads/services/restaurant-large.jpg"
    },
    {
      "id_service": 3,
      "service_title": "Zoo Gift Shop",
      "service_description": "Browse our selection of souvenirs, toys, and educational materials.",
      "link": "/shop",
      "type": "service",
      "media_path": "/uploads/services/gift-shop.jpg",
      "media_path_medium": "/uploads/services/gift-shop-medium.jpg",
      "media_path_large": "/uploads/services/gift-shop-large.jpg"
    }
  ]
}

Service Types

Services are categorized into three types: Featured services are highlighted offerings displayed prominently on the homepage. These typically include:
  • Special tours
  • Premium experiences
  • Educational programs

Regular Services

Standard services and facilities available to all visitors:
  • Restaurants and cafes
  • Gift shops
  • Restrooms and facilities
  • Information centers

Habitat Services

Services specific to individual habitats:
  • Habitat-specific guided tours
  • Feeding demonstrations
  • Educational presentations

Error Responses

Resource Not Found

When the services endpoint is not available:
{
  "error": true,
  "message": "Resource 'services' not found"
}
HTTP Status Code: 404 Not Found

Notes

The Services API returns all services regardless of type. You can filter services by type on the client side using the type field.
Service images are available in three sizes (original, medium, large) to optimize for different display contexts and screen sizes.

Build docs developers (and LLMs) love