Skip to main content

​
Base URL

http://localhost:8080/kinconecta/api/tours/destinations

​
Get All Destinations

​
GET /kinconecta/api/tours/destinations
endpoint
Retrieve a list of all destinations in the platform.

​
Response

​
destinations
array
Array of destination objects

​
Example

curl -X GET http://localhost:8080/kinconecta/api/tours/destinations

​
Get Destination by ID

​
GET /kinconecta/api/tours/destinations/{destinationId}
endpoint
Retrieve details of a specific destination by its ID.

​
Path Parameters

​
destinationId
long
required
The unique identifier of the destination

​
Response

Returns a single destination object with the same structure as described in Get All Destinations.

​
Example

curl -X GET http://localhost:8080/kinconecta/api/tours/destinations/1

​
Create Destination

​
POST /kinconecta/api/tours/destinations
endpoint
Create a new destination in the system.

​
Request Body

​
city
string
required
City name
​
country
string
required
Country name
​
description
string
required
Description of the destination
​
favorite
boolean
required
Whether this destination should be marked as favorite

​
Response

Returns the created destination object including the generated destinationId.

​
Example

curl -X POST http://localhost:8080/kinconecta/api/tours/destinations \
  -H "Content-Type: application/json" \
  -d '{
    "city": "Tokyo",
    "country": "Japan",
    "description": "A bustling metropolis blending traditional and modern culture",
    "favorite": true
  }'

​
Update Destination

​
PUT /kinconecta/api/tours/destinations/{destinationId}
endpoint
Update an existing destination by its ID.

​
Path Parameters

​
destinationId
long
required
The unique identifier of the destination to update

​
Request Body

Accepts the same fields as Create Destination. All fields are optional - only include fields you want to update.
​
city
string
City name
​
country
string
Country name
​
description
string
Description of the destination
​
favorite
boolean
Whether this destination should be marked as favorite

​
Response

Returns the updated destination object.

​
Example

curl -X PUT http://localhost:8080/kinconecta/api/tours/destinations/1 \
  -H "Content-Type: application/json" \
  -d '{
    "description": "The City of Light, renowned for the Eiffel Tower, Louvre Museum, and exquisite cuisine",
    "favorite": true
  }'

​
Delete Destination

​
DELETE /kinconecta/api/tours/destinations/{destinationId}
endpoint
Delete a destination by its ID.

​
Path Parameters

​
destinationId
long
required
The unique identifier of the destination to delete

​
Response

Returns the deleted destination object.

​
Example

curl -X DELETE http://localhost:8080/kinconecta/api/tours/destinations/1

​
Add Tour to Destination

​
POST /kinconecta/api/tours/destinations/{destinationId}-add-tour
endpoint
Associate a tour with a destination.

​
Path Parameters

​
destinationId
long
required
The unique identifier of the destination

​
Response

Returns the updated destination object with the new tour association.

​
Example

curl -X POST http://localhost:8080/kinconecta/api/tours/destinations/1-add-tour

Build docs developers (and LLMs) love

Get started for freeTalk to us