API ONEKEYSTAYS
Autenticazione: Authorization: Bearer <JWT> oppure X-API-Key: okst_…. Webhook firmati con X-OneKeyStays-Signature. Catalogo eventi: /api/v1/events.
| Metodo | Percorso | Accesso | Permesso | Note |
|---|---|---|---|---|
GET | /api/public/checkin/{token} | public | ||
POST | /api/public/checkin/{token} | public | ||
POST | /api/public/checkin/{token}/document | public | ||
POST | /api/public/{org}/book | public | ||
GET | /api/public/{org}/properties | public | ||
GET | /api/public/{org}/search | public | ||
GET | /api/v1/api-keys | user | apikeys:read | |
POST | /api/v1/api-keys | user | apikeys:write | |
DELETE | /api/v1/api-keys/{id} | user | apikeys:write | |
POST | /api/v1/auth/login | public | ||
GET | /api/v1/automations | user | automations:read | |
POST | /api/v1/automations | user | automations:write | |
GET | /api/v1/availability | user | pms:read | |
GET | /api/v1/calendar | user | pms:read | Planning: unità × giorni con prenotazioni. |
GET | /api/v1/channels | user | channels:read | |
POST | /api/v1/channels | user | channels:write | |
POST | /api/v1/channels/{id}/import-ical | user | channels:write | |
GET | /api/v1/channels/{id}/log | user | channels:read | |
POST | /api/v1/channels/{id}/mappings | user | channels:write | |
POST | /api/v1/channels/{id}/sync | user | channels:write | |
GET | /api/v1/compliance/alloggiati | user | alloggiati:read | |
PUT | /api/v1/compliance/alloggiati/config | user | alloggiati:write | |
POST | /api/v1/compliance/alloggiati/send | user | alloggiati:write | |
GET | /api/v1/compliance/istat | user | istat:read | |
GET | /api/v1/dashboard | user | pms:read | |
GET | /api/v1/dev/audit | owner | ||
GET | /api/v1/dev/orgs | owner | ||
POST | /api/v1/dev/orgs | owner | ||
PATCH | /api/v1/dev/orgs/{id} | owner | ||
PUT | /api/v1/dev/orgs/{id}/flags | owner | Body: {"rms_ai": true, "crm": false, "smartlock": null} (null = torna al default del piano). | |
GET | /api/v1/dev/overview | owner | ||
GET | /api/v1/dev/users | owner | ||
POST | /api/v1/dev/users | owner | ||
PATCH | /api/v1/dev/users/{id} | owner | ||
GET | /api/v1/events | public | ||
GET | /api/v1/guests | user | crm:read | |
POST | /api/v1/guests | user | crm:write | |
GET | /api/v1/guests/{id} | user | crm:read | |
PATCH | /api/v1/guests/{id} | user | crm:write | |
POST | /api/v1/inbound-hooks | user | webhooks:write | |
GET | /api/v1/locks | user | locks:read | |
POST | /api/v1/locks | user | locks:write | |
GET | /api/v1/marketplace | user | marketplace:read | |
DELETE | /api/v1/marketplace/{key} | user | marketplace:write | |
POST | /api/v1/marketplace/{key}/install | user | marketplace:write | |
GET | /api/v1/me | user | ||
GET | /api/v1/message-templates | user | crm:read | |
POST | /api/v1/message-templates | user | crm:write | |
POST | /api/v1/messages | user | crm:write | |
GET | /api/v1/meta/plans | public | ||
GET | /api/v1/payments | user | payments:read | |
PUT | /api/v1/payments/stripe/config | user | payments:write | |
POST | /api/v1/payments/{id}/refund | user | payments:write | |
GET | /api/v1/properties | user | pms:read | |
POST | /api/v1/properties | user | pms:write | |
GET | /api/v1/properties/{id} | user | pms:read | |
PATCH | /api/v1/properties/{id} | user | pms:write | |
POST | /api/v1/quote | user | pms:read | |
POST | /api/v1/rate-plans | user | rates:write | |
PUT | /api/v1/rates | user | rates:write | |
GET | /api/v1/reservations | user | pms:read | |
POST | /api/v1/reservations | user | pms:write | |
GET | /api/v1/reservations/{id} | user | pms:read | |
PATCH | /api/v1/reservations/{id} | user | pms:write | |
GET | /api/v1/reservations/{id}/access-codes | user | locks:read | |
POST | /api/v1/reservations/{id}/access-codes | user | locks:write | |
DELETE | /api/v1/reservations/{id}/access-codes | user | locks:write | |
POST | /api/v1/reservations/{id}/cancel | user | pms:write | |
POST | /api/v1/reservations/{id}/check-in | user | pms:write | |
POST | /api/v1/reservations/{id}/check-out | user | pms:write | |
POST | /api/v1/reservations/{id}/confirm | user | pms:write | |
GET | /api/v1/reservations/{id}/documents/{gid} | user | checkin:read | |
POST | /api/v1/reservations/{id}/folio | user | pms:write | |
POST | /api/v1/reservations/{id}/no-show | user | pms:write | |
POST | /api/v1/reservations/{id}/payments | user | payments:write | |
POST | /api/v1/rms/apply | user | rms:write | |
POST | /api/v1/rms/competitors | user | rms:write | |
POST | /api/v1/rms/events | user | rms:write | |
GET | /api/v1/rms/insights | user | rms:read | |
POST | /api/v1/rms/recommendations | user | rms:read | |
GET | /api/v1/room-types | user | pms:read | |
POST | /api/v1/room-types | user | pms:write | |
POST | /api/v1/segments/preview | user | crm:read | |
GET | /api/v1/tasks | user | pms:read | |
POST | /api/v1/tasks | user | pms:write | |
POST | /api/v1/tasks/{id}/done | user | pms:write | |
POST | /api/v1/units | user | pms:write | |
POST | /api/v1/units/{id}/status | user | pms:write | |
GET | /api/v1/users | user | admin:users | |
POST | /api/v1/users | user | admin:users | |
PATCH | /api/v1/users/{id} | user | admin:users | |
GET | /api/v1/webhook-deliveries | user | webhooks:read | |
GET | /api/v1/webhooks | user | webhooks:read | |
POST | /api/v1/webhooks | user | webhooks:write | |
DELETE | /api/v1/webhooks/{id} | user | webhooks:write | |
POST | /api/v1/webhooks/{id}/test | user | webhooks:write | |
POST | /channels/{id}/webhook/{sig} | public | Prenotazioni push dalle OTA/switch: JSON Channex o XML OTA_HotelResNotifRQ. | |
POST | /hooks/in/{token} | public | ||
GET | /ical/{room_type_id}/{sig}.ics | public | ||
POST | /payments/stripe/webhook | public |