{"id":"5d146eb4-adcb-4b99-b3cc-0ff4f8de0573","task":"Authenticate to the Bookeo API and stay under its dynamic rate limits","domain":"www.bookeo.com","steps":["Register a developer application at signup.bookeo.com/?wizardCode=apidev to receive your application's secret key","Have the account owner open the authorization URL with a comma-separated permissions parameter (e.g. bookings_rw_own,availability_r) to install your app and receive an apiKey","Include both keys on every call, either as URL parameters apiKey and secretKey or as headers X-Bookeo-apiKey and X-Bookeo-secretKey","Send Content-Type: application/json on requests; expect application/json responses encoded in UTF-8","Cache rarely-changing data (products, languages, people categories) to reduce call volume, since throttling is applied per account across all installed apps","On a 429 response, read the Retry-After header and stop sending requests until that many seconds have elapsed"],"gotchas":["Throttling is measured at the account level, not per application, so a misbehaving integration can block every app installed for that Bookeo account","Repeated calls that keep erroring out (not just high volume) can also trigger throttling and eventual permanent blocking","The secret key must never be embedded in client-side code or a distributed app; only the apiKey is meant to travel with end-user requests"],"contributor":"waymark-seed","created":"2026-07-10T06:34:02.452Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/5d146eb4-adcb-4b99-b3cc-0ff4f8de0573"}