API za rezervacije
Primjer
Rezervacija s vašeg servera — PHP i Node.js.
Ključ držite u varijabli okruženja (APPOTIO_API_KEY), nikad u kodu koji stiže do
preglednika. Vaša web stranica šalje obrazac vašem serveru, koji ga provjeri
(zaštita od spama, ispravni podaci) i tek onda pozove Appotio.
PHP
<?php
function appotio(string $method, string $path, array $data = []): array
{
$ch = curl_init('https://app.appotio.com/api/v1' . $path);
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => $method,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('APPOTIO_API_KEY'),
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => $method === 'POST' ? json_encode($data) : null,
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
return [$status, $body];
}
// Slobodna vremena za uslugu na dan.
[, $day] = appotio('GET', '/availability?' . http_build_query([
'service_id' => $_GET['service_id'],
'date' => $_GET['date'],
]));
// Rezervacija — nakon vaše zaštite od spama i provjere podataka.
[$status, $booking] = appotio('POST', '/appointments', [
'service_id' => $_POST['service_id'],
'date' => $_POST['date'],
'start_time' => $_POST['start_time'],
'first_name' => $_POST['first_name'],
'last_name' => $_POST['last_name'],
'phone' => $_POST['phone'], // +385911234567
'email' => $_POST['email'],
]);
if ($status === 201) {
echo 'Gotovo! Potvrdite termin iz poruke do ' . $booking['confirm_until']['time'] . '.';
} elseif (($booking['errors']['start_time']['code'] ?? null) === 'SLOT_TAKEN') {
echo 'To vrijeme je upravo zauzeto — odaberite drugo.';
} else {
echo 'Rezervacija nije uspjela.';
}Node.js
const API = 'https://app.appotio.com/api/v1'
async function appotio(method, path, data) {
const res = await fetch(API + path, {
method,
headers: {
Authorization: `Bearer ${process.env.APPOTIO_API_KEY}`,
'Content-Type': 'application/json',
},
body: data ? JSON.stringify(data) : undefined,
})
return { status: res.status, body: await res.json() }
}
// Organizacija: usluge, zaposlenici i pravila — spremite na nekoliko minuta.
const { body: salon } = await appotio('GET', '/salon')
// Dani sa slobodnim vremenima, za kalendar u obrascu.
const { body: days } = await appotio(
'GET',
`/days?service_id=${serviceId}&from=2026-10-07&to=2026-10-31`,
)
// Rezervacija iz vašeg obrasca, nakon vaše provjere.
const { status, body } = await appotio('POST', '/appointments', {
service_id: serviceId,
date: '2026-10-09',
start_time: '10:00',
first_name: 'Ana',
last_name: 'Horvat',
phone: '+385911234567',
email: '[email protected]',
})
if (status === 429) {
// Previše zahtjeva: pričekajte Retry-After sekundi.
}Pravi obrazac će još prikazati baznu cijenu uz cijenu, zasiviti dane bez slobodnih
vremena (/days), ponuditi recommended vremena prva i, ako organizacija to dopušta, izbor
zaposlenika.