{"id":24560,"date":"2026-11-04T21:59:49","date_gmt":"2026-11-04T21:59:49","guid":{"rendered":"https:\/\/alteg.io\/?p=24560"},"modified":"2026-11-05T10:44:54","modified_gmt":"2026-11-05T10:44:54","slug":"booking-api-integration","status":"publish","type":"post","link":"https:\/\/alteg.io\/cs\/blog\/booking-api-integration\/","title":{"rendered":"Booking API integration for salons, spas and clinics"},"content":{"rendered":"<p>A booking API integration that holds up in production follows one pattern: a middleware layer sits between your scheduling platform and every other system, reads free time slots, creates appointments and consumes webhooks when appointments are created, changed or deleted. Hand this brief to your developer, give the integration only the access it needs and settle the GDPR roles before anyone writes code. The examples use the Altegio API, documented on the <a href=\"https:\/\/developer.alteg.io\/en\">Altegio developer portal<\/a>.<\/p>\n<p><strong>Your immediate next steps:<\/strong><\/p>\n<ul>\n<li>Check whether a ready-made app in the Integrations Hub already does the job before you commission custom work.<\/li>\n<li>Paste the checklist below into a developer ticket.<\/li>\n<li>Decide which user the integration\u2019s user token belongs to and keep that user\u2019s access to what the job needs.<\/li>\n<li>Sign a data processing agreement with whoever builds or hosts the middleware.<\/li>\n<\/ul>\n<hr>\n<h2 id=\"key-takeaways\">Key takeaways<\/h2>\n<table>\n<thead>\n<tr>\n<th>Point<\/th>\n<th>Details<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Start with middleware<\/td>\n<td>Put one layer between the platform and every consumer: website, CRM, BI dashboard, AI tools.<\/td>\n<\/tr>\n<tr>\n<td>Use the right credentials<\/td>\n<td>A partner token for the public online booking endpoints; a partner token plus a user token for business data. Keep both in a secrets manager.<\/td>\n<\/tr>\n<tr>\n<td>Treat webhooks as at-least-once<\/td>\n<td>Deduplicate by X-Hook-Id, don\u2019t rely on order and run a reconciliation job for anything missed.<\/td>\n<\/tr>\n<tr>\n<td>Respect the rate limit<\/td>\n<td>200 requests a minute or 5 a second per IP address: cache services and team members, query time slots live.<\/td>\n<\/tr>\n<tr>\n<td>Phase the rollout<\/td>\n<td>A draft application on your own test Location first, then read-only, assisted and automated stages.<\/td>\n<\/tr>\n<tr>\n<td>Settle GDPR roles<\/td>\n<td>The business is the controller; a developer or agency processing data on its behalf is a processor and needs an Article 28 contract.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<hr>\n<h2 id=\"which-booking-api-surfaces-do-you-actually-need\">Which booking API surfaces do you actually need?<\/h2>\n<p>Every booking integration touches the same three flows, whatever the platform: read free time slots, create an appointment and react to changes through webhooks. Everything else (clients, services, payments, analytics) supports those three. In the Altegio API they are spread across three documented sets.<\/p>\n<table>\n<thead>\n<tr>\n<th>What you need<\/th>\n<th>Where it lives in the Altegio API<\/th>\n<th>Credentials<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Services, team members, dates and free time slots for a booking flow<\/td>\n<td><a href=\"https:\/\/developer.alteg.io\/en\/public\/openapi\">Online Booking API<\/a>: <code>book_services<\/code>, <code>book_staff<\/code>, <code>book_dates<\/code>, <code>book_times<\/code><\/td>\n<td>Partner token<\/td>\n<\/tr>\n<tr>\n<td>Validate and create an online appointment, change its date or time<\/td>\n<td>Online Booking API: <code>book_check<\/code>, <code>book_record<\/code><\/td>\n<td>Partner token<\/td>\n<\/tr>\n<tr>\n<td>List, read, edit or delete appointments, change attendance status, see change history<\/td>\n<td><a href=\"https:\/\/developer.alteg.io\/en\/b2b-v2\/openapi\">Business Management API<\/a>: <code>\/locations\/{location_id}\/appointments<\/code> and related methods<\/td>\n<td>Partner token + user token<\/td>\n<\/tr>\n<tr>\n<td>Search and add clients<\/td>\n<td>Business Management API: client methods<\/td>\n<td>Partner token + user token<\/td>\n<\/tr>\n<tr>\n<td>Get or send a payment link for an appointment<\/td>\n<td>Business Management API: <code>\/locations\/{location_id}\/appointments\/{record_id}\/payment_link<\/code><\/td>\n<td>Partner token + user token<\/td>\n<\/tr>\n<tr>\n<td>Notifications about changes<\/td>\n<td><a href=\"https:\/\/developer.alteg.io\/en\/developers\/openapi\">Webhooks<\/a>: appointment, client, team member, service, schedule, product operation, financial operation and loyalty card events<\/td>\n<td>Webhook settings per Location<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>The Online Booking API is the public set behind booking widgets and client portals, so it needs no user authentication. The Business Management API covers scheduling, clients, inventory, finances and loyalty. Both its V1 and V2 are in production, and V2 is the one recommended for new integrations.<\/p>\n<p><strong>Pro Tip:<\/strong> <em>Cache services and team members and refresh the cache when a service, team member or schedule webhook arrives. Query time slots live every time \u2013 stale slot data is how double bookings happen.<\/em><\/p>\n<hr>\n<h2 id=\"how-does-a-secure-middleware-architecture-actually-work\">How does a secure middleware architecture actually work?<\/h2>\n<p>The middleware is the engine of your integration. It sits between the platform\u2019s API and every consumer (website widget, CRM, BI dashboard, AI model) and does the work those consumers should never do directly: it authenticates, queues and throttles requests, receives webhooks and logs every call.<\/p>\n<p><strong>Middleware responsibilities:<\/strong><\/p>\n<ul>\n<li><strong>Credentials:<\/strong> keep the partner token and user token in a secrets manager, never in code or in a browser, and know how you will replace them if they leak.<\/li>\n<li><strong>Throttling:<\/strong> queue bursts on your side to stay under the rate limit; the documentation lists no rate-limit headers to wait for.<\/li>\n<li><strong>Webhook intake:<\/strong> return a 2xx status straight away and process the event from a queue.<\/li>\n<li><strong>Deduplication and ordering:<\/strong> the same event can arrive twice, and different events can arrive out of order.<\/li>\n<li><strong>Reconciliation:<\/strong> a scheduled job pulls appointments changed since the last run and repairs anything a webhook missed.<\/li>\n<li><strong>Audit logging:<\/strong> every inbound webhook and outbound call, with a timestamp and a correlation ID.<\/li>\n<li><strong>Client data handling:<\/strong> strip or pseudonymise client details before they reach AI models or analytics tools.<\/li>\n<li><strong>Orchestration:<\/strong> multi-step flows (check slot \u2192 validate \u2192 create \u2192 confirm) run as one tracked sequence, so a failure halfway leaves a clear state.<\/li>\n<\/ul>\n<p>Cache what changes slowly, query live what changes by the minute and keep live calls for the operations that matter. That is the strategic case for this architecture: the platform stays the source of truth for appointments, and you can swap the tools around it without rebuilding the core.<\/p>\n<p><strong>Pro Tip:<\/strong> <em>Give each consumer only what it needs. A CRM connector should read clients and appointments; it has no reason to touch finances or schedules. In Altegio, the user token belongs either to your installed application\u2019s system user or to a business user you authorise, and their Location access and permissions can differ \u2013 choose deliberately.<\/em><\/p>\n<hr>\n<h2 id=\"step-by-step-technical-checklist-for-your-developer\">Step-by-step technical checklist for your developer<\/h2>\n<p>Hand this list to your developer as a ticket. Each step is a separate deliverable.<\/p>\n<ol>\n<li><strong>Discovery:<\/strong> read Getting Started on developer.alteg.io and pick the API set for each flow. The base URL is <code>https:\/\/api.alteg.io\/api<\/code>, every request goes over TLS 1.2 or higher, and date-times use ISO 8601 with an offset.<\/li>\n<li><strong>Credentials:<\/strong> take the partner token from your developer account and, for business data, add a user token (see <a href=\"https:\/\/alteg.io\/en\/support\/knowledge-base\/187675\/\">how to get Altegio API keys<\/a> and <a href=\"https:\/\/developer.alteg.io\/en\/get-api-key\">getting credentials<\/a> on the portal). Send them as <code>Authorization: Bearer &lt;partner_token&gt;, User &lt;user_token&gt;<\/code> together with <code>Accept: application\/vnd.api.v2+json<\/code>.<\/li>\n<li><strong>Test environment:<\/strong> there is no separate sandbox. Install a draft application on your own test Location, activate it and make authenticated calls there before moderation and before any live data is involved.<\/li>\n<li><strong>Webhooks:<\/strong> subscribe to the resource types you need in the webhook settings (<a href=\"https:\/\/alteg.io\/en\/support\/knowledge-base\/4870052386973\/\">help-centre guide to webhooks<\/a>) and build the receiver to the rules in the next section.<\/li>\n<li><strong>Duplicate protection on writes:<\/strong> the API documents no idempotency-key header. Put your own reference into the appointment\u2019s <code>api_id<\/code> field (external appointment ID) and, after a timeout, check whether the appointment exists before you retry the create.<\/li>\n<li><strong>Rate limits:<\/strong> throttle to stay under 200 requests a minute and 5 a second per IP address; on HTTP 429, back off before retrying.<\/li>\n<li><strong>Errors and retries:<\/strong> retry 429 and 5xx with exponential back-off and a hard cap on attempts; alert a person on 401 and 403, which point to credentials or permissions; don\u2019t retry other 4xx errors \u2013 fix the request.<\/li>\n<li><strong>Reconciliation:<\/strong> run a scheduled job that lists appointments with <code>changed_after<\/code> set to the last successful run (the list method also takes <code>with_deleted<\/code>) and repairs any gaps.<\/li>\n<li><strong>Audit logging:<\/strong> log method, endpoint, status code, latency, correlation ID and a pseudonymised client reference for every call.<\/li>\n<\/ol>\n<p><strong>Minimal HTTP examples:<\/strong><\/p>\n<pre><code># 1. Free time slots for one team member on one day\n#    (Online Booking API, partner token only)\nGET https:\/\/api.alteg.io\/api\/v1\/book_times\/{location_id}\/{team_member_id}\/2026-12-15?service_ids[]=331\nAccept: application\/vnd.api.v2+json\nContent-Type: application\/json\nAuthorization: Bearer &lt;partner_token&gt;\n\n# 2. Validate with POST \/v1\/book_check\/{location_id}, then create the appointment\nPOST https:\/\/api.alteg.io\/api\/v1\/book_record\/{location_id}\nAccept: application\/vnd.api.v2+json\nContent-Type: application\/json\nAuthorization: Bearer &lt;partner_token&gt;\n\n{\n  \"phone\": \"+48500100200\",\n  \"fullname\": \"Anna Kowalska\",\n  \"email\": \"anna@example.com\",\n  \"api_id\": \"web-2026-000123\",\n  \"appointments\": [\n    { \"id\": 1, \"services\": [331], \"staff_id\": 6544, \"datetime\": \"2026-12-15T10:00:00+01:00\" }\n  ]\n}\n\n# 3. Business data needs both tokens (Business Management API)\nGET https:\/\/api.alteg.io\/api\/v1\/locations\/{location_id}\/appointments?changed_after=2026-12-15T00:00:00\nAccept: application\/vnd.api.v2+json\nContent-Type: application\/json\nAuthorization: Bearer &lt;partner_token&gt;, User &lt;user_token&gt;\n<\/code><\/pre>\n<p>The Online Booking API also has methods to change an appointment\u2019s date and time and to send an SMS confirmation code when a Location asks clients to confirm their phone number. Field names follow the API, not the interface: a Location appears as <code>company<\/code> or <code>location<\/code>, a team member as <code>staff<\/code> and an appointment as <code>record<\/code>.<\/p>\n<hr>\n<h2 id=\"how-should-your-middleware-handle-webhooks\">How should your middleware handle webhooks?<\/h2>\n<p>Webhooks are where integrations break quietly, so build the receiver to the documented behaviour from day one.<\/p>\n<ul>\n<li><strong>Envelope:<\/strong> each POST carries JSON with <code>company_id<\/code> (the Location), <code>resource<\/code> (for example <code>record<\/code> for an appointment or <code>client<\/code>), <code>resource_id<\/code>, <code>status<\/code> (<code>create<\/code>, <code>update<\/code> or <code>delete<\/code>) and <code>data<\/code> with the record itself. There is no separate \u201ccancelled\u201d event: read <code>data<\/code> to see what changed.<\/li>\n<li><strong>Timing:<\/strong> events are queued and sent about 5 seconds after the change. Each attempt times out after 10 seconds in total and 5 seconds for the connection, and only a 2xx response counts as delivered.<\/li>\n<li><strong>Retries:<\/strong> failures before the request reaches you, HTTP 429 and 5xx are retried up to twice, 5 and then 30 seconds after the previous attempt. A timeout after the request was sent and other 4xx answers are not retried, so a slow handler can lose an event \u2013 which is why you reconcile.<\/li>\n<li><strong>Duplicates:<\/strong> delivery is at-least-once. The <code>X-Hook-Id<\/code> header is a UUID that stays the same across retries; store it and skip anything you have already processed. A retry carries the current state of the resource, so its <code>data<\/code> can differ from the first attempt.<\/li>\n<li><strong>Order:<\/strong> notifications for different events are not guaranteed to arrive in order. Compare with the record you hold instead of assuming the latest webhook is the latest state.<\/li>\n<li><strong>Authenticity:<\/strong> requests carry the <code>Authorization: Bearer<\/code> token configured for webhooks. It is shared, not a secret unique to your URL, and the documentation describes no payload signature. Check the header, check that <code>company_id<\/code> is a Location you serve and, before writing anything, re-read the record through the API.<\/li>\n<li><strong>Debugging:<\/strong> there is no delivery log, test send or replay for partners, so keep your own log of every <code>X-Hook-Id<\/code> and test with real appointments on your test Location.<\/li>\n<\/ul>\n<p><strong>Webhook skeleton and handler:<\/strong><\/p>\n<pre><code class=\"language-json\">POST https:\/\/your-middleware.example\/altegio\/webhooks\nContent-Type: application\/json\nAuthorization: Bearer &lt;configured_token&gt;\nX-Hook-Id: 6f1d2c3a-8b4e-4f7a-9c21-5e0b7d9a1f42\n\n{\n  \"company_id\": 123456,\n  \"resource\": \"record\",\n  \"resource_id\": 501,\n  \"status\": \"update\",\n  \"data\": { \"id\": 501, \"staff_id\": 101, \"datetime\": \"2026-12-15T10:00:00+01:00\", \"attendance\": 0, \"services\": [ ... ], \"client\": { ... } }\n}\n\n# Handler (pseudocode)\nif header[\"Authorization\"] != configured_token: return 401\nif seen(header[\"X-Hook-Id\"]): return 200\nenqueue(header[\"X-Hook-Id\"], body); return 200      # well inside the 10-second timeout\n\n# Worker: re-read the record through the API, apply the change, mark the X-Hook-Id as processed\n# Nightly: list appointments with changed_after = last successful run and repair gaps\n<\/code><\/pre>\n<p><strong>Pro Tip:<\/strong> <em>To prove your deduplication works, make your test endpoint return a 500 on purpose. The retries arrive with the same X-Hook-Id, and your log should show one processed event, not three.<\/em><\/p>\n<hr>\n<h2 id=\"ai-and-automation-patterns-mapped-to-booking-api-endpoints\">AI and automation patterns mapped to booking API endpoints<\/h2>\n<p>Design AI and automation around specific API surfaces, and don\u2019t rebuild what the platform already does. Altegio sends <a href=\"https:\/\/alteg.io\/en\/sms-and-email-notification\/\">automatic notifications<\/a> (appointment notifications, confirmation requests, reminders, repeat-visit invitations and a feedback request after an Arrived visit) and runs loyalty programmes natively, so your middleware should add to those, not duplicate them.<\/p>\n<p><strong>Four practical automation sequences:<\/strong><\/p>\n<ol>\n<li><strong>Chat booking:<\/strong> client message \u2192 intent parser \u2192 <code>book_times<\/code> \u2192 offer options \u2192 client confirms \u2192 <code>book_check<\/code> \u2192 <code>book_record<\/code>. Altegio\u2019s automatic notifications then take over, depending on how the Location has set them up.<\/li>\n<li><strong>No-show risk:<\/strong> nightly job \u2192 appointments for the next two days \u2192 score each client on their history \u2192 a list of high-risk appointments for the front desk to call. Altegio sends one reminder per appointment, so the call is the extra step for risky ones.<\/li>\n<li><strong>BI sync:<\/strong> appointment and financial operation webhooks \u2192 queue \u2192 data warehouse; the nightly <code>changed_after<\/code> job fills any gaps.<\/li>\n<li><strong>CRM sync:<\/strong> client webhook \u2192 match by phone \u2192 update the CRM contact; marketing status lives in the CRM (see the GDPR section).<\/li>\n<\/ol>\n<p>If what you need is an AI assistant that works inside your Altegio account rather than a custom bot, look at the <a href=\"https:\/\/alteg.io\/en\/mcp\/\">Altegio MCP server<\/a> first (<a href=\"https:\/\/alteg.io\/en\/support\/knowledge-base\/382638\/\">help-centre guide<\/a>): it connects an AI assistant to Altegio without middleware of your own.<\/p>\n<p><strong>Pro Tip:<\/strong> <em>Start with read-only automations. Switch on each new recipe behind a feature flag and keep a human approval step for anything that changes or deletes an appointment until you trust the data.<\/em><\/p>\n<hr>\n<h2 id=\"security-privacy-and-gdpr-in-europe\">Security, privacy and GDPR in Europe<\/h2>\n<p>The GDPR (Regulation 2016\/679) applies to every client record your integration touches, in every EU and EEA country. Start with roles, because they decide who signs what.<\/p>\n<p><strong>Who is who:<\/strong><\/p>\n<ul>\n<li>The salon, spa or clinic decides why and how client data is processed, so it is the controller (Article 4(7)).<\/li>\n<li>A developer, agency or hosting provider that runs the middleware on the business\u2019s behalf is a processor (Article 4(8)). The controller may use only processors that give sufficient guarantees (Article 28(1)), and the processing must be governed by a contract \u2013 a data processing agreement \u2013 that sets out its subject-matter, duration, nature and purpose, the type of data and the categories of people concerned (Article 28(3)).<\/li>\n<li>That agreement must, among other things, oblige the processor to act only on documented instructions, ensure the people handling the data are bound by confidentiality, apply the security measures of Article 32, help the controller answer data subject requests and delete or return the data when the work ends (Article 28(3)(a), (b), (c), (e) and (g)).<\/li>\n<li>The processor may not bring in another processor \u2013 a cloud host, a logging service, an AI provider \u2013 without the controller\u2019s prior written authorisation (Article 28(2)).<\/li>\n<\/ul>\n<p><strong>Security controls checklist:<\/strong><\/p>\n<ul>\n<li>Separate credentials per integration, kept in a secrets manager, with the least access that does the job.<\/li>\n<li>Encrypted transport everywhere: the Altegio API already requires TLS 1.2 or higher, and your webhook endpoint should be HTTPS only.<\/li>\n<li>Encryption at rest and pseudonymisation for any client data you cache \u2013 Article 32(1)(a) names both as examples of appropriate measures.<\/li>\n<li>Role-based access on the middleware itself and no shared admin logins.<\/li>\n<li>Audit logs with a retention period you have decided and written down.<\/li>\n<li>Data minimisation: each downstream system gets only the fields it needs (Article 5(1)(c)).<\/li>\n<\/ul>\n<p><strong>GDPR specifics for booking data:<\/strong><\/p>\n<ul>\n<li><strong>Lawful basis:<\/strong> the data needed to book and deliver an appointment can usually rely on the performance of a contract (Article 6(1)(b)). For email and SMS marketing, plan on consent (Article 6(1)(a)): national rules implementing the ePrivacy Directive 2002\/58\/EC also apply, and they differ between EU countries.<\/li>\n<li><strong>Health data:<\/strong> clinics and aesthetic practices often hold data concerning health, a special category under Article 9 that may be processed only under one of its exceptions, such as explicit consent. Keep visit notes and medical fields out of tools that don\u2019t need them.<\/li>\n<li><strong>Consent records:<\/strong> Altegio\u2019s booking form has a mandatory personal-data consent checkbox but no marketing-consent checkbox and no consent timestamp, and opt-outs are set by hand in the client card (Exclude). If you run marketing, capture and store consent in the marketing tool and make sure opt-outs reach every system that sends messages.<\/li>\n<li><strong>Data subject rights:<\/strong> the controller must be able to answer access, rectification and erasure requests (Chapter III) across every connected system. In Altegio, deleting a client card doesn\u2019t delete that client\u2019s appointments and payments, so plan erasure system by system rather than trusting one delete.<\/li>\n<li><strong>Records of processing:<\/strong> each controller keeps a record of processing activities (Article 30). Add every data flow the integration creates, including each processor.<\/li>\n<li><strong>Hosting:<\/strong> check where the middleware and every connected tool store data. If anything leaves the EEA, review the transfer rules with your data protection adviser.<\/li>\n<\/ul>\n<p><strong>Pro Tip:<\/strong> <em>Never store raw client details next to model outputs. Pass the platform\u2019s client ID or a pseudonymised reference to your AI model; the middleware resolves it back to a name only when a person needs to act.<\/em><\/p>\n<hr>\n<h2 id=\"how-should-you-test-and-roll-out-the-integration-safely\">How should you test and roll out the integration safely?<\/h2>\n<p>A phased rollout catches integration bugs before they reach real clients.<\/p>\n<p><strong>Five-phase rollout:<\/strong><\/p>\n<ol>\n<li><strong>Test Location:<\/strong> a draft application on your own test Location; the three core flows pass, webhook deduplication is proven with forced retries, and a reconciliation run finds no gaps.<\/li>\n<li><strong>Read-only:<\/strong> connect the read methods to your CRM and BI; no writes to live data yet.<\/li>\n<li><strong>Assisted:<\/strong> team members create appointments through the new interface while the middleware logs every call.<\/li>\n<li><strong>Conditional automation:<\/strong> automated flows run, but changes and deletions still need human approval.<\/li>\n<li><strong>Full rollout:<\/strong> all recipes active; feature flags stay in place for instant rollback.<\/li>\n<\/ol>\n<p><strong>KPIs to monitor from day one:<\/strong><\/p>\n<ul>\n<li>Appointment creation success rate (2xx responses \/ attempts).<\/li>\n<li>Webhook health: duplicates skipped and gaps found by reconciliation.<\/li>\n<li>API error rate by endpoint and status code, including 429s.<\/li>\n<li>End-to-end latency from the client\u2019s request to the appointment being created.<\/li>\n<li>Business results: no-show rate and revenue per appointment.<\/li>\n<\/ul>\n<p><strong>Pro Tip:<\/strong> <em>Assign a correlation ID where every request enters the middleware and carry it through every log line. When something breaks at night, it is the fastest way from symptom to cause.<\/em><\/p>\n<hr>\n<h2 id=\"what-does-a-booking-api-integration-actually-cost-and-how-long-does-it-take\">What does a booking API integration actually cost and how long does it take?<\/h2>\n<p>There is no honest single number. Effort depends on how many systems you connect, whether the integration only reads or also writes, how many Locations it covers and how strict your data protection requirements are. A read-only BI feed for one Location is a much smaller job than a two-way CRM sync for a chain.<\/p>\n<p>The cheapest integration is the one you don\u2019t build. Check the Integrations Hub first: ready-made apps connect from the Integrations menu without custom code. If you only need to pass events to another tool, Altegio webhooks with Webhooks by Zapier (a paid Zapier plan) may be enough \u2013 there is no native Altegio app on Zapier.<\/p>\n<p>For custom work, budget for the parts that take time on any platform: data mapping, webhook handling, reconciliation, testing on a test Location and the data processing agreement. Altegio\u2019s API team offers architecture feedback before you ship; the contact details are on the developer portal.<\/p>\n<hr>\n<h2 id=\"how-do-payments-checkout-and-inventory-fit-in\">How do payments, checkout and inventory fit in?<\/h2>\n<p>Online payments in Altegio run through a connected provider \u2013 Stripe, or Adyen in EU countries \u2013 and Altegio charges no commission of its own on them. Through the API you can get a payment link for an appointment and send it to the client, and <a href=\"https:\/\/alteg.io\/en\/payment-policy-no-show-protection\/\">payment policies<\/a> such as deposits are set up in Altegio itself rather than in middleware.<\/p>\n<p>If you run an external till or online shop, listen to financial operation and product operation webhooks and reconcile them by appointment. Consumables don\u2019t need middleware: <a href=\"https:\/\/alteg.io\/en\/inventory-control\/\">inventory control<\/a> in Altegio writes them off automatically through bills of materials linked to services, and the Sales by Services report shows consumables cost, payroll and profit per service. There are no low-stock alerts or automatic reordering, so if you want them, build them in middleware from product operation events and your own reorder thresholds.<\/p>\n<hr>\n<h2 id=\"how-do-you-handle-timezones-and-localisation-in-appointment-scheduling\">How do you handle time zones and localisation in appointment scheduling?<\/h2>\n<p>Store every date-time in UTC in the middleware and convert to local time only at the presentation layer, using the IANA time zone of each Location (for example <code>Europe\/Lisbon<\/code>, <code>Europe\/Warsaw<\/code>, <code>Europe\/Helsinki<\/code>). The Altegio API exchanges date-times in ISO 8601 with an offset, such as <code>2026-09-21T23:00:00.000-05:00<\/code>, and durations in seconds (900 = 15 minutes), so pass the offset through rather than stripping it.<\/p>\n<p>Most of the EU uses three standard time zones, from UTC+0 in mainland Portugal and Ireland to UTC+2 in Finland and Romania, and all of them switch to summer time. A client booking a Warsaw appointment from Lisbon must see the right time in both places: accept local time in the interface, keep the offset in the request, store UTC and render in the Location\u2019s time zone on confirmation.<\/p>\n<p>Localisation goes beyond time zones. Date formats differ (DD.MM.YYYY in Germany, Poland and Czechia; DD\/MM\/YYYY in France, Spain and Italy), and so do currencies (EUR, PLN, CZK, HUF, RON, SEK and others) and the language of automated messages. Resolve all of them from the Location record and never hard-code them in the middleware.<\/p>\n<hr>\n<h2 id=\"how-should-you-version-and-maintain-backward-compatibility\">How should you version and maintain backward compatibility?<\/h2>\n<p>Altegio versions its API in the URL path (<code>\/v1\/<\/code>, <code>\/v2\/<\/code>). Both versions are in production: new features may appear in V2 only, and V1 is maintained for backward compatibility. V2 is recommended for new integrations; the examples above use V1 methods that remain supported. At the time of writing, a V3 contract is published as a preview only and can\u2019t serve calls yet.<\/p>\n<p>Watch the developer portal for changes and run your full test suite on your test Location before moving live traffic to a new version or method. If your middleware exposes its own API to other tools, version it the same way and announce deprecations well in advance.<\/p>\n<p>Never rely on undocumented fields. Treat anything not in the official schema as volatile and parse defensively: if a field is missing, use a safe default instead of throwing an exception.<\/p>\n<hr>\n<h2 id=\"what-happens-to-your-integration-under-high-booking-volumes\">What happens to your integration under high booking volumes?<\/h2>\n<p>At high volume the hard limit is the rate limit: 200 requests a minute or 5 a second per IP address. A chain that polls every Location every few minutes reaches it quickly, so the design must lean on webhooks and caching rather than polling.<\/p>\n<p>Put a message queue between webhook intake and processing. Intake answers well inside the 10-second timeout, the queue absorbs spikes and the processing workers scale horizontally.<\/p>\n<hr>\n<h2 id=\"how-do-you-map-your-data-model-to-the-booking-api\">How do you map your data model to the booking API?<\/h2>\n<p>Data mapping is where integrations lose the most time, so do it in discovery, not during the build.<\/p>\n<p><strong>Core entity mappings:<\/strong><\/p>\n<ul>\n<li><strong>Location:<\/strong> <code>company_id<\/code> \/ <code>location_id<\/code> in the API \u2194 the site or branch ID in your other systems. Every Location belongs to a Chain, even in a single-location business.<\/li>\n<li><strong>Client:<\/strong> platform client ID \u2194 CRM contact ID; map name, phone, email and preferred language. Online appointments require a phone number, which makes phone the most reliable matching key.<\/li>\n<li><strong>Appointment:<\/strong> record ID, services, team member (<code>staff_id<\/code>), <code>datetime<\/code>, attendance status and the <code>api_id<\/code> you set; this feeds no-show scoring and BI. Altegio uses four appointment statuses: Pending, Confirmed, Arrived and No-show.<\/li>\n<li><strong>Services:<\/strong> durations come in seconds; map each service to the product codes your till or shop uses if you sync sales.<\/li>\n<li><strong>Availability:<\/strong> always ask the API for free time slots (<code>book_times<\/code>) instead of computing them from working hours, because existing appointments, technical breaks and resources all affect the answer.<\/li>\n<\/ul>\n<p>Decide the sync frequency per data type during discovery: appointment status in real time through webhooks, client profile changes through client webhooks, and visit history for analytics in a nightly <code>changed_after<\/code> job.<\/p>\n<hr>\n<h2 id=\"how-do-you-connect-your-booking-system-to-a-crm-or-marketing-platform\">How do you connect your booking system to a CRM or marketing platform?<\/h2>\n<p>A CRM sync is a two-way flow. New clients created through <a href=\"https:\/\/alteg.io\/en\/online-booking\/\">online booking<\/a> reach your CRM through client webhooks, and CRM updates flow back through the client methods of the Business Management API, matched by phone. The Altegio <a href=\"https:\/\/alteg.io\/en\/client-base\/\">client base<\/a> stays the record your front desk works from.<\/p>\n<p>Triggers map naturally. An appointment create event can start a welcome flow in the CRM for a first-time client; an appointment marked Arrived can update the client\u2019s lifetime value; a no-show can open a follow-up task for the front desk. Altegio already sends its automatic notifications, so don\u2019t duplicate confirmations, reminders or feedback requests from the CRM.<\/p>\n<p>Altegio has no bulk email, so newsletters belong in an email marketing platform. Build segments there \u2013 for example \u201cbooked three times in 90 days\u201d or \u201ccancelled twice\u201d \u2013 from the appointment data the middleware feeds in, and keep consent and opt-outs in that platform too, because Altegio\u2019s booking form doesn\u2019t collect marketing consent.<\/p>\n<hr>\n<h2 id=\"altegio-gives-you-the-api-and-the-integrations-to-build-on\">Altegio gives you the API and the integrations to build on<\/h2>\n<p>Altegio is <a href=\"https:\/\/alteg.io\/en\/online-scheduling-software\/\">appointment scheduling software<\/a> for appointment-based businesses: beauty, wellness, clinics, auto services, fitness and more. For integrations it gives you:<\/p>\n<ul>\n<li>Ready-made apps in the Integrations Hub, connected from the Integrations menu.<\/li>\n<li>The Open API \u2013 Online Booking and Business Management sets \u2013 documented on developer.alteg.io.<\/li>\n<li>Webhooks for appointments, clients, team members, services, schedules, products, finances and loyalty cards.<\/li>\n<li>An MCP server for connecting an AI assistant to your account.<\/li>\n<li>Built-in modules your middleware can lean on instead of rebuilding them: online booking, client base, automatic notifications, inventory and <a href=\"https:\/\/alteg.io\/en\/statistics-and-analytics\/\">analytics<\/a>.<\/li>\n<\/ul>\n<p>Pricing depends on the number of team members and the billing period (<a href=\"https:\/\/alteg.io\/en\/pricing\/\">see pricing<\/a>). Start a <a href=\"https:\/\/alteg.io\/en\/onboarding\/first\/\">7-day free trial<\/a> and have your developer read the documentation in parallel.<\/p>\n<hr>\n<h2 id=\"faq\">FAQ<\/h2>\n<h3 id=\"what-are-the-three-core-flows-in-a-booking-api-integration\">What are the three core flows in a booking API integration?<\/h3>\n<p>Read free time slots, create the appointment and handle webhooks for appointments that are created, updated or deleted. In the Altegio Online Booking API, the first two are <code>book_times<\/code> and <code>book_record<\/code>, with <code>book_check<\/code> to validate the parameters in between.<\/p>\n<h3 id=\"how-do-you-prevent-duplicate-appointments-when-retrying-api-calls\">How do you prevent duplicate appointments when retrying API calls?<\/h3>\n<p>The Altegio API documents no idempotency-key header, so protect yourself in the middleware: store your own reference in <code>api_id<\/code> and, after a timeout, check whether the appointment was created before retrying. On the incoming side, deduplicate webhooks by <code>X-Hook-Id<\/code>, which stays the same across retries.<\/p>\n<h3 id=\"does-altegio-sign-its-webhooks\">Does Altegio sign its webhooks?<\/h3>\n<p>The documentation describes an <code>Authorization: Bearer<\/code> token configured for webhooks, shared rather than unique to your URL, and no payload signature. Check the header and the <code>company_id<\/code>, and re-read the record through the API before writing anything based on a webhook.<\/p>\n<h3 id=\"what-gdpr-requirements-apply-to-booking-api-integrations-in-europe\">What GDPR requirements apply to booking API integrations in Europe?<\/h3>\n<p>Clear roles (the business as controller, the integrator as processor) with an Article 28 data processing agreement, a lawful basis for each purpose, data minimisation, support for data subject requests across every system, a record of processing activities and appropriate security such as encryption. Clinics need extra care with health data, a special category under Article 9.<\/p>\n<h3 id=\"can-altegio-be-used-as-the-platform-for-this-middleware-architecture\">Can Altegio be used as the platform for this middleware architecture?<\/h3>\n<p>Yes. Altegio has public Online Booking endpoints, a Business Management API for appointments, clients, services, team members, finances and more, and webhooks on changes. Requests use a partner token, plus a user token for business data. There is no separate sandbox: install a draft application on your own test Location and develop there.<\/p>\n<h3 id=\"does-altegio-work-with-zapier\">Does Altegio work with Zapier?<\/h3>\n<p>There is no native Altegio app on Zapier. You can connect the two through Altegio webhooks and Webhooks by Zapier, which needs a paid Zapier plan, or go through the Open API.<\/p>\n<hr>\n<h2 id=\"read-next\">Read next<\/h2>\n<ul>\n<li><a href=\"https:\/\/alteg.io\/en\/blog\/building-software-for-salons\/\">Building software for salons? 12 tools to code it and sell it<\/a><\/li>\n<li><a href=\"https:\/\/alteg.io\/en\/blog\/vibe-coded-booking-system-risks\/\">What you\u2019re really buying from a vibe coder<\/a><\/li>\n<li><a href=\"https:\/\/alteg.io\/en\/blog\/how-to-choose-salon-booking-system\/\">A salon booking system: how to choose<\/a><\/li>\n<li><a href=\"https:\/\/alteg.io\/en\/blog\/payment-policy-card-guarantee-adyen\/\">Payment policies, card guarantee and Adyen<\/a><\/li>\n<\/ul>\n<p><em>This article is general information, not legal or tax advice; rules differ between EU countries.<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"<p>A developer brief for booking API integration: middleware, partner and user tokens, webhook deduplication, rate limits and GDPR roles in Europe.<\/p>\n","protected":false},"author":34,"featured_media":24542,"comment_status":"closed","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"footnotes":"","_members_access_role":[],"_members_access_error":""},"categories":[447,959],"tags":[193,286],"class_list":["post-24560","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-podnikani-cs","category-rizeni","tag-booking-software","tag-online-booking"],"aioseo_notices":[],"aioseo_head":"\n\t\t<!-- All in One SEO Pro 5.0.2 - aioseo.com -->\n\t<meta name=\"description\" content=\"A developer brief for booking API integration: middleware, partner and user tokens, webhook deduplication, rate limits and GDPR roles in Europe.\" \/>\n\t<meta name=\"robots\" content=\"max-image-preview:large\" \/>\n\t<meta name=\"author\" content=\"Giorgio Altegi\"\/>\n\t<link rel=\"canonical\" href=\"https:\/\/alteg.io\/cs\/blog\/booking-api-integration\/\" \/>\n\t<meta name=\"generator\" content=\"All in One SEO Pro (AIOSEO) 5.0.2\" \/>\n\t\t<meta property=\"og:locale\" content=\"cs_CZ\" \/>\n\t\t<meta property=\"og:site_name\" content=\"The Altegio Times - Online Booking and Business Management Media\" \/>\n\t\t<meta property=\"og:type\" content=\"article\" \/>\n\t\t<meta property=\"og:title\" content=\"Booking API integration for salons, spas and clinics\" \/>\n\t\t<meta property=\"og:description\" content=\"A developer brief for booking API integration: middleware, partner and user tokens, webhook deduplication, rate limits and GDPR roles in Europe.\" \/>\n\t\t<meta property=\"og:url\" content=\"https:\/\/alteg.io\/cs\/blog\/booking-api-integration\/\" \/>\n\t\t<meta property=\"og:image\" content=\"https:\/\/alteg.io\/blog\/wp-content\/uploads\/2026\/11\/booking-api-integration-og.jpg\" \/>\n\t\t<meta property=\"og:image:secure_url\" content=\"https:\/\/alteg.io\/blog\/wp-content\/uploads\/2026\/11\/booking-api-integration-og.jpg\" \/>\n\t\t<meta property=\"og:image:width\" content=\"1260\" \/>\n\t\t<meta property=\"og:image:height\" content=\"720\" \/>\n\t\t<meta property=\"article:published_time\" content=\"2026-11-04T21:59:49+00:00\" \/>\n\t\t<meta property=\"article:modified_time\" content=\"2026-11-05T10:44:54+00:00\" \/>\n\t\t<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n\t\t<meta name=\"twitter:title\" content=\"Booking API integration for salons, spas and clinics\" \/>\n\t\t<meta name=\"twitter:description\" content=\"A developer brief for booking API integration: middleware, partner and user tokens, webhook deduplication, rate limits and GDPR roles in Europe.\" \/>\n\t\t<meta name=\"twitter:image\" content=\"https:\/\/alteg.io\/blog\/wp-content\/uploads\/2026\/11\/booking-api-integration-og.jpg\" \/>\n\t\t<script type=\"application\/ld+json\" class=\"aioseo-schema\">\n\t\t\t{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"BlogPosting\",\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/blog\\\/booking-api-integration\\\/#blogposting\",\"name\":\"Booking API integration for salons, spas and clinics\",\"headline\":\"Booking API integration for salons, spas and clinics\",\"author\":{\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/blog\\\/author\\\/giorgio-a\\\/#author\"},\"publisher\":{\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/#organization\"},\"image\":{\"@type\":\"ImageObject\",\"url\":\"https:\\\/\\\/alteg.io\\\/blog\\\/wp-content\\\/uploads\\\/2026\\\/08\\\/booking-api-integration-hero.avif\",\"width\":1260,\"height\":720,\"caption\":\"Booking API integration for salons, spas and clinics\"},\"datePublished\":\"2026-11-04T21:59:49+00:00\",\"dateModified\":\"2026-11-05T10:44:54+00:00\",\"inLanguage\":\"cs-CZ\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/blog\\\/booking-api-integration\\\/#webpage\"},\"isPartOf\":{\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/blog\\\/booking-api-integration\\\/#webpage\"},\"articleSection\":\"Podnik\\u00e1n\\u00ed, \\u0158\\u00edzen\\u00ed, booking software, online booking, Optional\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/blog\\\/booking-api-integration\\\/#breadcrumblist\",\"itemListElement\":[{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/#listItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/alteg.io\\\/cs\\\/\",\"nextItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/blog\\\/category\\\/podnikani-cs\\\/#listItem\",\"name\":\"Podnik\\u00e1n\\u00ed\"}},{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/blog\\\/category\\\/podnikani-cs\\\/#listItem\",\"position\":2,\"name\":\"Podnik\\u00e1n\\u00ed\",\"item\":\"https:\\\/\\\/alteg.io\\\/cs\\\/blog\\\/category\\\/podnikani-cs\\\/\",\"nextItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/blog\\\/booking-api-integration\\\/#listItem\",\"name\":\"Booking API integration for salons, spas and clinics\"},\"previousItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/#listItem\",\"name\":\"Home\"}},{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/blog\\\/booking-api-integration\\\/#listItem\",\"position\":3,\"name\":\"Booking API integration for salons, spas and clinics\",\"previousItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/blog\\\/category\\\/podnikani-cs\\\/#listItem\",\"name\":\"Podnik\\u00e1n\\u00ed\"}}]},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/#organization\",\"name\":\"The Altegio Times\",\"description\":\"Online Booking and Business Management Media\",\"url\":\"https:\\\/\\\/alteg.io\\\/cs\\\/\"},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/blog\\\/author\\\/giorgio-a\\\/#author\",\"url\":\"https:\\\/\\\/alteg.io\\\/cs\\\/blog\\\/author\\\/giorgio-a\\\/\",\"name\":\"Giorgio Altegi\",\"image\":{\"@type\":\"ImageObject\",\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/blog\\\/booking-api-integration\\\/#authorImage\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/e98af92d829543c69d64b43e9494de1727197de020fdafacba8601656bd45cfc?s=96&d=initials&r=g&initials=GA\",\"width\":96,\"height\":96,\"caption\":\"Giorgio Altegi\"}},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/blog\\\/booking-api-integration\\\/#webpage\",\"url\":\"https:\\\/\\\/alteg.io\\\/cs\\\/blog\\\/booking-api-integration\\\/\",\"name\":\"Booking API integration for salons, spas and clinics\",\"description\":\"A developer brief for booking API integration: middleware, partner and user tokens, webhook deduplication, rate limits and GDPR roles in Europe.\",\"inLanguage\":\"cs-CZ\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/#website\"},\"breadcrumb\":{\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/blog\\\/booking-api-integration\\\/#breadcrumblist\"},\"author\":{\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/blog\\\/author\\\/giorgio-a\\\/#author\"},\"creator\":{\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/blog\\\/author\\\/giorgio-a\\\/#author\"},\"image\":{\"@type\":\"ImageObject\",\"url\":\"https:\\\/\\\/alteg.io\\\/blog\\\/wp-content\\\/uploads\\\/2026\\\/08\\\/booking-api-integration-hero.avif\",\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/blog\\\/booking-api-integration\\\/#mainImage\",\"width\":1260,\"height\":720,\"caption\":\"Booking API integration for salons, spas and clinics\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/blog\\\/booking-api-integration\\\/#mainImage\"},\"datePublished\":\"2026-11-04T21:59:49+00:00\",\"dateModified\":\"2026-11-05T10:44:54+00:00\"},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/#website\",\"url\":\"https:\\\/\\\/alteg.io\\\/cs\\\/\",\"name\":\"The Altegio Times\",\"description\":\"Online Booking and Business Management Media\",\"inLanguage\":\"cs-CZ\",\"publisher\":{\"@id\":\"https:\\\/\\\/alteg.io\\\/cs\\\/#organization\"}}]}\n\t\t<\/script>\n\t\t<!-- All in One SEO Pro -->\r\n\t\t<title>Booking API integration for salons, spas and clinics<\/title>\n\n","aioseo_head_json":{"title":"Booking API integration for salons, spas and clinics","description":"A developer brief for booking API integration: middleware, partner and user tokens, webhook deduplication, rate limits and GDPR roles in Europe.","canonical_url":"https:\/\/alteg.io\/cs\/blog\/booking-api-integration\/","robots":"max-image-preview:large","keywords":"","webmasterTools":{"miscellaneous":""},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"BlogPosting","@id":"https:\/\/alteg.io\/cs\/blog\/booking-api-integration\/#blogposting","name":"Booking API integration for salons, spas and clinics","headline":"Booking API integration for salons, spas and clinics","author":{"@id":"https:\/\/alteg.io\/cs\/blog\/author\/giorgio-a\/#author"},"publisher":{"@id":"https:\/\/alteg.io\/cs\/#organization"},"image":{"@type":"ImageObject","url":"https:\/\/alteg.io\/blog\/wp-content\/uploads\/2026\/08\/booking-api-integration-hero.avif","width":1260,"height":720,"caption":"Booking API integration for salons, spas and clinics"},"datePublished":"2026-11-04T21:59:49+00:00","dateModified":"2026-11-05T10:44:54+00:00","inLanguage":"cs-CZ","mainEntityOfPage":{"@id":"https:\/\/alteg.io\/cs\/blog\/booking-api-integration\/#webpage"},"isPartOf":{"@id":"https:\/\/alteg.io\/cs\/blog\/booking-api-integration\/#webpage"},"articleSection":"Podnik\u00e1n\u00ed, \u0158\u00edzen\u00ed, booking software, online booking, Optional"},{"@type":"BreadcrumbList","@id":"https:\/\/alteg.io\/cs\/blog\/booking-api-integration\/#breadcrumblist","itemListElement":[{"@type":"ListItem","@id":"https:\/\/alteg.io\/cs\/#listItem","position":1,"name":"Home","item":"https:\/\/alteg.io\/cs\/","nextItem":{"@type":"ListItem","@id":"https:\/\/alteg.io\/cs\/blog\/category\/podnikani-cs\/#listItem","name":"Podnik\u00e1n\u00ed"}},{"@type":"ListItem","@id":"https:\/\/alteg.io\/cs\/blog\/category\/podnikani-cs\/#listItem","position":2,"name":"Podnik\u00e1n\u00ed","item":"https:\/\/alteg.io\/cs\/blog\/category\/podnikani-cs\/","nextItem":{"@type":"ListItem","@id":"https:\/\/alteg.io\/cs\/blog\/booking-api-integration\/#listItem","name":"Booking API integration for salons, spas and clinics"},"previousItem":{"@type":"ListItem","@id":"https:\/\/alteg.io\/cs\/#listItem","name":"Home"}},{"@type":"ListItem","@id":"https:\/\/alteg.io\/cs\/blog\/booking-api-integration\/#listItem","position":3,"name":"Booking API integration for salons, spas and clinics","previousItem":{"@type":"ListItem","@id":"https:\/\/alteg.io\/cs\/blog\/category\/podnikani-cs\/#listItem","name":"Podnik\u00e1n\u00ed"}}]},{"@type":"Organization","@id":"https:\/\/alteg.io\/cs\/#organization","name":"The Altegio Times","description":"Online Booking and Business Management Media","url":"https:\/\/alteg.io\/cs\/"},{"@type":"Person","@id":"https:\/\/alteg.io\/cs\/blog\/author\/giorgio-a\/#author","url":"https:\/\/alteg.io\/cs\/blog\/author\/giorgio-a\/","name":"Giorgio Altegi","image":{"@type":"ImageObject","@id":"https:\/\/alteg.io\/cs\/blog\/booking-api-integration\/#authorImage","url":"https:\/\/secure.gravatar.com\/avatar\/e98af92d829543c69d64b43e9494de1727197de020fdafacba8601656bd45cfc?s=96&d=initials&r=g&initials=GA","width":96,"height":96,"caption":"Giorgio Altegi"}},{"@type":"WebPage","@id":"https:\/\/alteg.io\/cs\/blog\/booking-api-integration\/#webpage","url":"https:\/\/alteg.io\/cs\/blog\/booking-api-integration\/","name":"Booking API integration for salons, spas and clinics","description":"A developer brief for booking API integration: middleware, partner and user tokens, webhook deduplication, rate limits and GDPR roles in Europe.","inLanguage":"cs-CZ","isPartOf":{"@id":"https:\/\/alteg.io\/cs\/#website"},"breadcrumb":{"@id":"https:\/\/alteg.io\/cs\/blog\/booking-api-integration\/#breadcrumblist"},"author":{"@id":"https:\/\/alteg.io\/cs\/blog\/author\/giorgio-a\/#author"},"creator":{"@id":"https:\/\/alteg.io\/cs\/blog\/author\/giorgio-a\/#author"},"image":{"@type":"ImageObject","url":"https:\/\/alteg.io\/blog\/wp-content\/uploads\/2026\/08\/booking-api-integration-hero.avif","@id":"https:\/\/alteg.io\/cs\/blog\/booking-api-integration\/#mainImage","width":1260,"height":720,"caption":"Booking API integration for salons, spas and clinics"},"primaryImageOfPage":{"@id":"https:\/\/alteg.io\/cs\/blog\/booking-api-integration\/#mainImage"},"datePublished":"2026-11-04T21:59:49+00:00","dateModified":"2026-11-05T10:44:54+00:00"},{"@type":"WebSite","@id":"https:\/\/alteg.io\/cs\/#website","url":"https:\/\/alteg.io\/cs\/","name":"The Altegio Times","description":"Online Booking and Business Management Media","inLanguage":"cs-CZ","publisher":{"@id":"https:\/\/alteg.io\/cs\/#organization"}}]},"og:locale":"cs_CZ","og:site_name":"The Altegio Times - Online Booking and Business Management Media","og:type":"article","og:title":"Booking API integration for salons, spas and clinics","og:description":"A developer brief for booking API integration: middleware, partner and user tokens, webhook deduplication, rate limits and GDPR roles in Europe.","og:url":"https:\/\/alteg.io\/cs\/blog\/booking-api-integration\/","og:image":"https:\/\/alteg.io\/blog\/wp-content\/uploads\/2026\/11\/booking-api-integration-og.jpg","og:image:secure_url":"https:\/\/alteg.io\/blog\/wp-content\/uploads\/2026\/11\/booking-api-integration-og.jpg","og:image:width":1260,"og:image:height":720,"article:published_time":"2026-11-04T21:59:49+00:00","article:modified_time":"2026-11-05T10:44:54+00:00","twitter:card":"summary_large_image","twitter:title":"Booking API integration for salons, spas and clinics","twitter:description":"A developer brief for booking API integration: middleware, partner and user tokens, webhook deduplication, rate limits and GDPR roles in Europe.","twitter:image":"https:\/\/alteg.io\/blog\/wp-content\/uploads\/2026\/11\/booking-api-integration-og.jpg"},"aioseo_meta_data":{"post_id":"24560","title":"#post_title","description":"A developer brief for booking API integration: middleware, partner and user tokens, webhook deduplication, rate limits and GDPR roles in Europe.","keywords":null,"keyphrases":{"focus":{"keyphrase":"","score":0,"analysis":{"keyphraseInTitle":{"score":0,"maxScore":9,"error":1}}},"additional":[]},"canonical_url":null,"og_title":null,"og_description":null,"og_object_type":"default","og_image_type":"custom_image","og_image_custom_url":"https:\/\/alteg.io\/blog\/wp-content\/uploads\/2026\/11\/booking-api-integration-og.jpg","og_image_custom_fields":null,"og_custom_image_width":null,"og_custom_image_height":null,"og_video":"","og_custom_url":null,"og_article_section":null,"og_article_tags":null,"twitter_use_og":true,"twitter_card":"default","twitter_image_type":"default","twitter_image_custom_url":null,"twitter_image_custom_fields":null,"twitter_title":null,"twitter_description":null,"schema_type":"default","schema_type_options":null,"pillar_content":false,"robots_default":true,"robots_noindex":false,"robots_noarchive":false,"robots_nosnippet":false,"robots_nofollow":false,"robots_noimageindex":false,"robots_noodp":false,"robots_notranslate":false,"robots_max_snippet":"-1","robots_max_videopreview":"-1","robots_max_imagepreview":"large","tabs":null,"priority":0,"frequency":"default","local_seo":null,"created":"2026-08-14 15:07:56","updated":"2026-11-08 18:32:06","seo_analyzer_scan_date":"2026-11-05 10:46:16","primary_term":null,"og_image_url":"https:\/\/alteg.io\/blog\/wp-content\/uploads\/2026\/11\/booking-api-integration-og.jpg","og_image_width":"0","og_image_height":"0","twitter_image_url":null,"schema":{"blockGraphs":[],"customGraphs":[],"default":{"data":{"Article":[],"Course":[],"Dataset":[],"FAQPage":[],"Movie":[],"Person":[],"Product":[],"ProductReview":[],"Car":[],"Recipe":[],"Service":[],"SoftwareApplication":[],"WebPage":[]},"graphName":"BlogPosting","isEnabled":true},"graphs":[]},"limit_modified_date":false,"ai":{"faqs":[],"keyPoints":[],"schemas":[],"titles":[],"descriptions":[],"socialPosts":{"email":[],"linkedin":[],"twitter":[],"facebook":[],"instagram":[]}},"breadcrumb_settings":null,"focus_keyword":null,"additional_keywords":null,"truseo_locale":null,"reviewed_by":null},"aioseo_breadcrumb":"<div class=\"aioseo-breadcrumbs\"><span class=\"aioseo-breadcrumb\">\n\t<a href=\"https:\/\/alteg.io\/cs\/\" title=\"Home\">Home<\/a>\n<\/span><span class=\"aioseo-breadcrumb-separator\">\u203a<\/span><span class=\"aioseo-breadcrumb\">\n\t<a href=\"https:\/\/alteg.io\/cs\/blog\/category\/podnikani-cs\/\" title=\"Podnik\u00e1n\u00ed\">Podnik\u00e1n\u00ed<\/a>\n<\/span><span class=\"aioseo-breadcrumb-separator\">\u203a<\/span><span class=\"aioseo-breadcrumb\">\n\tBooking API integration for salons, spas and clinics\n<\/span><\/div>","aioseo_breadcrumb_json":[{"label":"Home","link":"https:\/\/alteg.io\/cs\/"},{"label":"Podnik\u00e1n\u00ed","link":"https:\/\/alteg.io\/cs\/blog\/category\/podnikani-cs\/"},{"label":"Booking API integration for salons, spas and clinics","link":"https:\/\/alteg.io\/cs\/blog\/booking-api-integration\/"}],"_links":{"self":[{"href":"https:\/\/alteg.io\/cs\/blog\/wp-json\/wp\/v2\/posts\/24560","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/alteg.io\/cs\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/alteg.io\/cs\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/alteg.io\/cs\/blog\/wp-json\/wp\/v2\/users\/34"}],"replies":[{"embeddable":true,"href":"https:\/\/alteg.io\/cs\/blog\/wp-json\/wp\/v2\/comments?post=24560"}],"version-history":[{"count":5,"href":"https:\/\/alteg.io\/cs\/blog\/wp-json\/wp\/v2\/posts\/24560\/revisions"}],"predecessor-version":[{"id":56458,"href":"https:\/\/alteg.io\/cs\/blog\/wp-json\/wp\/v2\/posts\/24560\/revisions\/56458"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/alteg.io\/cs\/blog\/wp-json\/wp\/v2\/media\/24542"}],"wp:attachment":[{"href":"https:\/\/alteg.io\/cs\/blog\/wp-json\/wp\/v2\/media?parent=24560"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/alteg.io\/cs\/blog\/wp-json\/wp\/v2\/categories?post=24560"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/alteg.io\/cs\/blog\/wp-json\/wp\/v2\/tags?post=24560"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}