Bloom de Fleur developer and agent guide
Bloom de Fleur (bloomdefleur.com.cy) is a flower shop in Limassol, Cyprus, offering online flower orders, delivery and shop collection.
When to use this
Use this site to help a customer browse bouquets, flower boxes, baskets, preserved roses and gifts; compare current catalogue options; arrange shop collection; or contact a florist about a custom arrangement or delivery to a recipient in Cyprus.
How to read the site
Send a GET request to https://bloomdefleur.com.cy/ with `Accept: text/markdown` to read the homepage as Markdown. Send `Accept: text/html` for the normal storefront. Responses vary on Accept and honor media-type quality values. Unsupported types on the homepage return HTTP 406. Missing WordPress routes return HTTP 404 with a Markdown error when Markdown is preferred. GET and HEAD are supported; HEAD has the same headers without a body.
- Homepage Markdown
- Agent instructions
- Public URL sitemap
- Shop
- Contact the florist
Markdown negotiation is available on the English homepage and this guide. Other storefront pages retain their existing HTML behavior.
Ordering and data boundaries
Read current product pages for prices and availability. Do not treat this guide as a live inventory feed. Confirm delivery availability, timing, fees and substitutions with the shop when unclear. Use the existing storefront checkout for ordering with the customer's approval. Do not submit payments or personal details without authorization.
The public catalogue API below is read-only. There is no public ordering API or MCP server. It does not grant access to private WordPress or WooCommerce administration. For a custom integration, contact the shop to agree scope, authentication and data handling.
Public catalogue API
- OpenAPI 3.1.1 specification: Typed parameters, response schemas and unique operation IDs suitable for function-calling tools.
- Shop information: GET shop contact details and delivery guidance.
- Public catalogue: GET published catalogue products. Query parameters: page (1–1000, default 1), per_page (1–20, default 10). Use the returned ID for GET /wp-json/bloom/v1/products/{id}.
No authentication is required. Hidden, search-only and unpublished products are excluded, including when the caller is logged in. No customer/order data is exposed. Responses are JSON; errors use RFC 9457 application/problem+json with type, title, status, detail, code and resolution. Stock/prices may change; final totals and delivery conditions are determined by the storefront. Make sequential requests and respect the 20-item page cap; no guaranteed throughput or SLA is offered.
CLI
A Node.js 20+ read-only CLI is prepared for business, products and product lookup. Registry publication is pending; do not assume an npm package is available yet.