Skip to main content

Best Practices

Use the current base URL​

https://service-gateway.loscenotes.com/api

Use the correct auth model​

  • X-API-Key for external partner API endpoints
  • JWT for portal/management/admin surfaces
  • do not assume Bearer auth for /api/partner/*

Trust current reference pages over generic old examples​

Use these pages as the source for current integration behavior:

  • /docs/api-reference/public-api-quick-reference
  • /docs/api-reference/pricing
  • /docs/api-reference/checkout
  • /docs/api-reference/discounts-and-coupons
  • /docs/api-reference/reservations
  • /docs/api-reference/services

Handle money carefully​

  • API-facing pricing in booking flows is generally documented in cents
  • if a page calls out a metadata exception, follow that page’s note

Handle errors using the current envelope​

  • read top-level message, error, statusCode, path, requestId
  • inspect errors for validation details
  • inspect retryAfter for 429 responses