Service API Overview
Introduction to the Links Service API for third-party reservations: base URL, capabilities, and where to start.
In this article you'll learn about Introduction, then explore What you can do, and finally review Request shape.
Introduction
The Links Service API lets a third-party application read space availability and submit reservation requests for a tenant. It is the public surface that integrations bind to using an app key + secret pair.
All Service API requests are:
- HTTPS only, plain HTTP is rejected.
- JSON in, JSON out, request and response bodies use
application/json. - Versioned in the URL path. The current stable version is v1.
Base URL:
https://api.linkspowered.com/{lang}/service/v1
{lang} is tr or en. The locale only affects human-readable error messages, not the data shape.
What you can do
The Service API today supports two flows scoped per app:
spaces:read- list active spaces with their working hours and location metadata.spaces.availability:read- query open time slots for a space and date.spaces.reservations:request- submit a reservation that the tenant will approve or reject.
Reservations submitted via the Service API are created with status pending. The tenant admin receives an email with the request and reviews it from the dashboard. Your integration polls the booking endpoint or relies on the configured webhook (when available) to learn the outcome.
Request shape
Every authenticated request carries two custom headers:
X-Links-App-Key: lk_app_...
X-Links-App-Secret: lk_sec_...
A minimal availability call:
curl -H "X-Links-App-Key: $LINKS_APP_KEY" \
-H "X-Links-App-Secret: $LINKS_APP_SECRET" \
"https://api.linkspowered.com/tr/service/v1/spaces/availableTimeTable?spaceUuid=<uuid>&date=YYYY-MM-DD"
Successful responses are wrapped:
{
"status": true,
"success": true,
"data": { "...": "..." },
"msg": "Result found"
}
Failures share a consistent envelope:
{
"status": false,
"success": false,
"msg": "Invalid app credentials",
"error": { "code": "SERVICE_AUTH_INVALID" }
}
The error.code value is stable and safe to switch on in client code.