# ActuacionsCastelleres.cat API

The public API accepts booking inquiries for professional castellers performances.

## Discovery

- API catalog: `GET /.well-known/api-catalog`
- OpenAPI 3.1 description: `GET /openapi.json`
- Experimental ARD resource catalog: `GET /.well-known/ai-catalog.json`
- Draft Agent Skills discovery index: `GET /.well-known/agent-skills/index.json`

## Booking inquiries

`POST /api/contact` accepts the same booking inquiry represented by the website contact form. It expects JSON and returns JSON.

Every submission is protected by Cloudflare Turnstile: the required `turnstileToken` (action `contact`) is only issued to the interactive form on this origin, so the endpoint cannot be called headlessly. Agents should gather the event details with the user and then hand over to the localized contact page (for example https://actuacionscastelleres.cat/#contact) for the final submission.

The request fields and response codes are described in `/openapi.json`. No OAuth or API key authentication is offered because this is a public contact endpoint, not an authenticated customer API.