L-API ta' Sloted
API REST sempliċi u webhooks iffirmati għal bookings, klijenti u ħlasijiet, flimkien ma' Zapier u Make. Disponibbli fuq il-pjan Pro.
Awtentikazzjoni
Oħloq ċavetta tal-API f'Settings → API u integrazzjonijiet u ibgħatha bħala bearer token. Iċ-ċwievet huma ta' negozju wieħed.
curl https://sloted.app/api/v1/services \
-H "Authorization: Bearer sk_live_…"120 talba kull minuta għal kull ċavetta. Il-ħinijiet kollha huma UTC ISO 8601; il-flus huma f'unitajiet minuri (ċenteżmi) b'kodiċi tal-munita.
Endpoints
| GET | /api/v1/me | In-negozju li għalih hija din iċ-ċavetta (test tal-konnessjoni). |
| GET | /api/v1/services | Servizzi li jistgħu jiġu bbukkjati bit-tul u l-prezz. |
| GET | /api/v1/availability?service_id=…&from=2026-10-01&to=2026-10-07 | Ħinijiet liberi għal servizz bejn żewġ dati. |
| GET | /api/v1/bookings?from=…&to=…&status=confirmed&cursor=… | Bookings li jibdew f'perjodu, b'paġni permezz ta' cursor. |
| POST | /api/v1/bookings | Ibbukkja ħin liberu. Ikkonfermat mill-ewwel; il-ħlas isir personalment. |
| GET | /api/v1/bookings/{id} | Booking wieħed. |
| POST | /api/v1/bookings/{id}/reschedule | Ċaqlaq booking: { "start": "…" }. |
| POST | /api/v1/bookings/{id}/cancel | Ikkanċella booking (il-klijent jiġi infurmat). |
| GET | /api/v1/clients?email=… | Sib klijenti, eż. bl-email. |
| POST | /api/v1/clients | Oħloq klijent, jew irritorna dak li diġà jeżisti b'dik l-email/telefown. |
| POST | /api/v1/hooks | Abbona URL għal avveniment (REST hooks ta' Zapier/Make). |
| DELETE | /api/v1/hooks/{id} | Neħħi abbonament. |
Oħloq booking
curl -X POST https://sloted.app/api/v1/bookings \
-H "Authorization: Bearer sk_live_…" -H "Content-Type: application/json" \
-d '{
"service_id": "…",
"start": "2026-10-06T09:00:00Z",
"staff_id": null,
"client": { "first_name": "Anna", "email": "anna@example.com" },
"idempotency_key": "order-1234"
}'Għaddi idempotency_key biex it-tentattivi mill-ġdid ikunu siguri. Ħin li m'għadux liberu jirritorna 409, għalhekk qatt ma jkun hemm double booking.
Żbalji
{ "error": { "code": "slot_unavailable", "message": "That time is not available." } }
401 unauthorized · 403 plan_limit · 404 not_found · 409 slot_unavailable
422 validation_error · 429 rate_limitedWebhooks
Żid endpoints fid-dashboard jew permezz ta' /api/v1/hooks. Kull twassil huwa POST JSON iffirmat bis-sigriet tal-endpoint tiegħek.
- booking.created
- booking.updated
- booking.cancelled
- booking.completed
- booking.no_show
- payment.succeeded
- payment.refunded
- client.created
- form.submitted
POST https://your-app.example.com/sloted
Sloted-Event: booking.created
Sloted-Signature: t=1791234567,v1=5f2b…
{ "id": "evt_…", "type": "booking.created", "created": "2026-10-01T08:00:00Z",
"data": { "booking": { "id": "…", "status": "confirmed", "start": "…", "client": { … } } } }Kif tivverifika l-firma
import { createHmac, timingSafeEqual } from "node:crypto";
function verify(secret, rawBody, header) {
const { t, v1 } = Object.fromEntries(header.split(",").map((p) => p.split("=")));
if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false; // replay window
const expected = createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex");
return timingSafeEqual(Buffer.from(expected), Buffer.from(v1));
}Wieġeb b'kwalunkwe 2xx fi żmien 10 sekondi. It-twassil li jfalli jerġa' jiġi ppruvat b'backoff (8 tentattivi fuq madwar 4 siegħat). Il-payloads qatt ma jinkludu tweġibiet tal-formoli.
Zapier u Make
It-tnejn jużaw iċ-ċavetta tal-API. It-triggers jabbonaw b'REST hooks; l-azzjonijiet isejħu l-endpoints tal-bookings u l-klijenti.
POST /api/v1/hooks { "target_url": "https://hooks.zapier.com/…", "event": "booking.created" }
→ 201 { "id": "…", "secret": "whsec_…" }
DELETE /api/v1/hooks/{id} → 204