Appotio pomoć
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.

Na ovoj stranici