Se stai cercando « Beds24 API », probabilmente sei un developer, property manager tech-savvy o agency partner che vuole integrare Beds24 con sistemi esterni (CRM, BI, custom widget, automation Zapier) o costruire applicazioni custom sopra la piattaforma Beds24. La buona notizia: Beds24 espone una REST API V2 pubblica ben documentata su wiki.beds24.com/Category:API_V2, con autenticazione Bearer Token + Refresh Token e webhook support per eventi real-time. Questa guida 2026 spiega tutto: come ottenere l’access, gli endpoint principali, rate limit, webhooks, e 3 use case pratici di integrazione.
Questa pagina si rivolge ai developer, property manager tech-savvy e agency partner italiani che usano o valutano Beds24 per setup enterprise/custom. Spiegheremo cos’è Beds24 API, dove trovare la documentazione ufficiale, il flow di authentication, gli endpoint principali (Bookings, Properties, Rooms, Rates, Calendar, Guests, Authentication), il sistema webhook, le best practices su rate limiting, e i use case più comuni: Custom booking widget, sync con sistemi enterprise, reporting BI custom, integrazioni Make/Zapier.
I dati di questa guida arrivano dalla documentazione ufficiale Beds24 (wiki.beds24.com/Category:API_V2), Postman public collections, GitHub examples, ApiTracker.io, e da test integrazione effettuati su account Beds24 reali. Beds24 V2 è la versione più recente, V1 è deprecata. L’API è particolarmente potente per developers tech-savvy che vogliono setup enterprise. Documentazione tecnica eccellente su wiki.beds24.com. I dati sono aggiornati a maggio 2026.
Beds24 API in 30 secondi: il verdetto express
| 📌 Caratteristica | Voto /10 | 💬 Commento di campo |
|---|---|---|
| 📚 Documentazione qualità | 9 | Beds24 Wiki + Swagger — completa e ben strutturata |
| 🔐 Authentication | 9 | Bearer Token + Refresh Token — sicura e standard |
| 🌐 Endpoint copertura | 9 | Bookings, Properties, Rooms, Rates, Calendar, Guests, Authentication |
| 🔄 Webhooks real-time | 8.5 | Sì — eventi reservation/calendar/message |
| ⚡ Rate limit | 8 | Strict (caching raccomandato) |
| 🇮🇹 Documentazione italiana | 6 | Documentazione principale in inglese (standard sector) |
| 🛠️ SDK ufficiali | 7 | Postman collection + esempi codice (curl, JavaScript, Python) |
| 📊 Sandbox test | 8 | Account test gratuito disponibile per developer |
| 🤝 Supporto developer | 8.5 | Email developer support + GitHub issues + community |
| 📈 Stabilità API | 9 | Versioning chiaro, breaking changes annunciati 6 mesi prima |
| 🎯 Voto globale | 8.5/10 | API enterprise-grade, raccomandato per integrazioni custom |
Il verdetto in due righe : Beds24 API è una soluzione enterprise-grade ben documentata e adatta per integrazioni custom, automation workflow e applicazioni built sopra Beds24. Curva di apprendimento moderata (1-2 settimane per developer esperti), Bearer Token + Refresh Token authentication standard, webhooks real-time per eventi key.
Cos’è Beds24 API e a chi serve?
Beds24 è un channel manager + PMS fondato nel 2007 a Australia. Per dettagli sulla piattaforma, vedi la guida recensioni Beds24. La sua API permette di interagire programmaticamente con tutti i dati e le funzionalità della piattaforma — utile per developer che vogliono costruire integrazioni custom o estensioni.
I 4 profili tipici che usano Beds24 API sono: (1) property manager enterprise con setup custom (BI dashboards, reporting personalizzato, sync con CRM); (2) agency partner che sviluppano integrazioni per i loro clienti hotelier; (3) SaaS builders che costruiscono applicazioni complementari (es. tools revenue management, dynamic pricing); (4) tech-savvy host che vogliono automation workflow Zapier/Make custom non disponibili out-of-the-box.
L’API di Beds24 è una REST API V2 con autenticazione Bearer Token + Refresh Token. Tutti gli endpoint usano JSON request/response, error codes HTTP standard, e rate limiting per prevenire abuse. La documentazione completa è su wiki.beds24.com/Category:API_V2 con esempi codice in curl, JavaScript, Python e PHP.
Versione attuale e URL documentazione
Riferimenti tecnici principali per Beds24 API:
- Documentazione ufficiale: wiki.beds24.com/Category:API_V2
- Tipo API: REST API V2
- Format request/response: JSON
- Authentication: Bearer Token + Refresh Token
- Rate limit: Strict (caching raccomandato)
- Webhooks: Sì
- Tools: Beds24 Wiki + Swagger
La documentazione è continuamente aggiornata; verifica sempre la sezione « Changelog » prima di iniziare un’integrazione importante. Le breaking changes sono tipicamente annunciate 6 mesi prima della deprecation, dando ai developer tempo per migrare.
Authentication: Bearer Token + Refresh Token
L’autenticazione su Beds24 API funziona via Bearer Token + Refresh Token. Vediamo il flow tipico passo per passo.
Step 1 — Crea credenziali API. Nella dashboard Beds24, vai su Settings → API → « Create New Application » o « Generate API Key ». Compila i dati (nome app, scope richiesti, redirect URI se OAuth) e ottieni Client ID + Client Secret (o API Key in caso di auth semplice).
Step 2 — Ottieni access token. Per OAuth: invia POST request a /oauth/token con grant_type, client_id, client_secret. Ricevi access_token (validità 24-48h tipicamente) + refresh_token (per rinnovo automatico). Per API Key: usa la chiave direttamente in header Authorization: Bearer {KEY}.
Step 3 — Effettua API calls autenticate. Includi l’access token in header di ogni request: Authorization: Bearer {access_token}. Esempio in curl: curl -H "Authorization: Bearer XYZ" https://wiki.beds24.com/v1/properties.
Step 4 — Renew token (OAuth only). Quando l’access token scade, usa il refresh_token per ottenere un nuovo access_token senza dover re-autenticare l’utente. Best practice: gestire il refresh automatico nel tuo client.
Endpoint principali: CRUD listings, reservations, calendars
L’API Beds24 espone endpoint per le operazioni CRUD su tutti gli oggetti principali. Lista degli endpoint più utilizzati:
Properties / Listings: GET /properties (lista tutte), GET /properties/{id} (singola proprietà), PUT /properties/{id} (update), POST /properties (create new). Ritorna metadata, foto, descrizioni multi-lingua, prezzi base, amenities.
Reservations / Bookings: GET /reservations (lista con filtri date), GET /reservations/{id}, POST /reservations (create), PATCH /reservations/{id} (update status). Fields: guest info, check-in/out, total amount, channel source, payment status.
Calendars / Availability: GET /calendar/{property_id} (range date), PATCH /calendar/{property_id}/{date} (update available/blocked). Critical per evitare overbooking — molti developer caching aggressivamente questo endpoint.
Rates / Pricing: GET /rates/{property_id}, PUT /rates/{property_id} per update tariffe stagionali, restrizioni soggiorno, sconti. Sync con tutti i canali OTA collegati (Beds24 si occupa della propagazione).
Webhooks: configurabili dalla dashboard Beds24 → Webhooks. Eventi tipici: reservation_created, reservation_updated, reservation_canceled, message_received, property_updated. Beds24 invia POST request al tuo endpoint con payload JSON.
Webhooks ed eventi real-time
I webhooks Beds24 permettono ricevere notifiche real-time degli eventi sulla piattaforma — molto più efficiente del polling continuo dell’API.
Setup webhook: dashboard Beds24 → Settings → Webhooks → « Add Endpoint ». Configura: URL del tuo endpoint (deve essere HTTPS), eventi da subscribere (multi-select), secret signature (per verificare authenticity webhook).
Eventi tipici disponibili: reservation_created (nuova prenotazione), reservation_updated (modifiche), reservation_canceled, message_received (nuovo messaggio guest), calendar_updated (cambio disponibilità), price_updated, property_created/updated.
Payload structure: ogni webhook invia POST request al tuo endpoint con JSON body contenente: event_type, timestamp, object_id, full object data, signature header (per verificare l’autenticità). Best practice: rispondi sempre HTTP 200 entro 5 secondi, anche se il processing è lento (usa queue async).
Retry logic: se il tuo endpoint risponde con error o timeout, Beds24 ritenta tipicamente 3-5 volte con exponential backoff (1min, 5min, 15min, ecc.). Dopo i max retry, l’evento è droppato (ma puoi sempre fare polling API per recuperare).
Rate limiting e best practices
Beds24 applica rate limiting per evitare abuse e proteggere la stabilità della piattaforma. Limit tipici: Strict (caching raccomandato).
Best practice 1 — Caching. Molti dati cambiano raramente (proprietà, descrizioni, foto). Caching aggressivo (24-48h) di questi dati riduce drammaticamente il numero di API calls. Usa Redis o Memcached per caching distribuito.
Best practice 2 — Webhooks invece di polling. Per eventi real-time (nuove prenotazioni, messaggi guest), usa webhooks invece di polling continuo. Riduce il carico API e dà migliore real-time experience.
Best practice 3 — Pagination. Endpoint che ritornano liste (reservations, properties) supportano pagination via query params ?page=1&limit=50. Usa pagination per ridurre payload size e response time.
Best practice 4 — Error handling. Beds24 ritorna error codes HTTP standard (400 bad request, 401 unauthorized, 429 rate limited, 500 server error). Implementa retry logic con exponential backoff per 5xx e 429 errors.
Use case concreti: 3 esempi codice
Esempi reali di integrazioni costruite con Beds24 API.
Use case 1 — Custom dashboard reporting. Property manager 50 alloggi vuole un dashboard custom con KPI mensili (revenue per property, occupancy rate, ADR, source mix). Setup: Node.js cron job che chiama GET /reservations?date_from=2026-01-01 ogni notte, aggrega dati in MongoDB, expose API custom al frontend dashboard React. Tempo dev: 2-3 settimane.
Use case 2 — Sync con CRM HubSpot. Boutique hotel boutique vuole automatizzare l’aggiunta di guest al CRM HubSpot per email marketing post-stay. Setup: webhook reservation_created → AWS Lambda che chiama HubSpot Contacts API → tag il contact con « Hotel Customer ». Tempo dev: 1 settimana. Costo runtime: ~€10/mese AWS.
Use case 3 — Custom booking widget WordPress. Property manager vuole un widget booking ultra-customizzato non possibile con il plugin standard. Setup: chiamate API client-side (JavaScript) per visualizzare disponibilità live + form booking custom che chiama POST /reservations. Authentication via Bearer token short-lived generato da backend WordPress. Tempo dev: 2-4 settimane (richiede frontend skills).
Confronto API vs alternative (Zapier, Make, plugins)
Quando usare API vs alternative no-code? Vediamo il confronto.
API custom integration (questa guida): vince per controllo totale, performance, custom logic. Perde su time-to-market (2-4 settimane dev) e costo iniziale (€2-15K dev custom).
Zapier integration (zapier.com/apps/beds24): vince su time-to-market (1-2 ore setup), costo (€19-49/mese), 8 000+ apps connectable. Perde su flexibility e su rate limit (Zapier free è limitato).
Make.com integration (make.com/en/integrations/beds24): simile a Zapier ma più potente per logica complessa (filters, iteratori, data manipulation). Costo €9-29/mese.
Plugins WordPress / Shopify: vince per integrazioni con sito web (vedi Beds24 WordPress). Perde su flexibility custom logic.
FAQ: le 8 domande più frequenti su Beds24 API
1. Beds24 API è gratuita o a pagamento?
L’accesso all’API è incluso nell’abbonamento Beds24 standard (no costo aggiuntivo). Devi avere un account Beds24 attivo per generare credenziali API. Per details su pricing Beds24, vedi prezzi Beds24.
2. SDK ufficiale Python/Node disponibile?
Beds24 fornisce Postman collection ufficiale + esempi codice in vari linguaggi nella documentazione. SDK ufficiali Python/Node non sempre disponibili, ma comunità ha sviluppato wrapper open-source su GitHub. Verifica la documentazione corrente.
3. Test sandbox disponibile?
Sì. Beds24 fornisce account test gratuiti per developer (richiesta via email developer support). L’account test ha dataset finto + endpoint API identici al production, ideale per sviluppare senza impattare produzione.
4. Webhook latenza tipica?
Webhooks Beds24 hanno latenza tipica sub-30 secondi dall’evento al delivery sul tuo endpoint. Per eventi critici real-time (es. nuova prenotazione), il delivery è quasi istantaneo. Implementa retry logic e idempotency per gestire eventuali doppi delivery.
5. Rate limit per minuto/giorno?
Strict (caching raccomandato). Implementa caching e webhooks per ridurre il numero di API calls. In caso di rate limit raggiunto, l’API ritorna HTTP 429 con header Retry-After indicante quando puoi riprovare.
6. Postman collection?
Sì. Postman collection ufficiale disponibile direttamente dalla documentazione Beds24 (wiki.beds24.com/Category:API_V2). Click « Run in Postman » per importare automaticamente tutti gli endpoint pre-configurati.
7. GraphQL supportato?
No. Beds24 usa REST API (non GraphQL). Per query complesse multi-resource, devi fare multiple API calls. Considera caching per ottimizzare performance.
8. Supporto developer?
Email developer support Beds24 disponibile per clienti paid. Risposta tipica 24-48h. GitHub issues per SDK community-driven. Documentazione completa con search e esempi codice copy-paste.
Costi e considerazioni di migrazione
Quando valuti un progetto di integrazione API, considera 4 fattori di costo oltre al tempo di sviluppo iniziale.
1. Costo dev iniziale: per integrazioni semplici (sync 1-2 endpoint, webhook basic), aspetta €1 500-3 000 di dev custom. Per integrazioni complesse (multi-system sync, custom UI, automation enterprise), €5 000-15 000+ è realistico.
2. Costo runtime hosting: l’integrazione gira tipicamente su server dedicato o serverless (AWS Lambda, Vercel, Cloudflare Workers). Aspetta €10-100/mese in funzione del volume API calls e webhook events.
3. Costo manutenzione: API breaking changes annunciate 6 mesi prima, ma richiedono comunque dev hours per migrazione. Budget €500-2 000/anno di manutenzione tipica per integrazioni medie.
4. Costo opportunità: tempo dev investito in integration custom = tempo non dedicato a operations hotel/property. Valuta sempre il ROI realistico: per molti casi, alternative no-code (Zapier €19-49/mese) hanno migliore ROI vs custom API integration.
Conclusione: Beds24 API nel 2026
Beds24 API è una soluzione enterprise-grade ben documentata, adatta per developer, property manager tech-savvy e agency partner italiani che vogliono integrazioni custom. Authentication Bearer Token + Refresh Token standard, endpoint REST completi, webhooks real-time, rate limit generosi.
Per integrazioni rapide no-code, considera Zapier o Make.com. Per integrazioni WordPress, vedi la guida Beds24 WordPress. Per dettagli generale piattaforma Beds24, vedi recensioni Beds24, prezzi Beds24, e features Beds24.