# Casa Digital Platform

> Casa Digital is a multi-tenant CMS and CRM for small businesses. Each client website reads its content from the platform's Site API and posts the leads its forms collect back to it; the platform owns all the data and hosts the backoffice where the business edits its content and works those leads.

- Contract version 4.1.0 (semver — compare the major and log loudly on a mismatch).
- A client site can do exactly three things: read its own content, create a lead, and fetch an asset. Content editing, CRM access, notifications and billing are backoffice-only and have no public API.
- API keys are issued by Casa Digital when a site is provisioned. There is no self-service signup and no endpoint that mints a key.
- Empty content is a 200 with defaulted values, never a 404: a site whose content has not been authored yet must still render.

## Build a website on the platform (start here)

- [Client site integration contract](https://www.casadigital.pt/api/v1/integration.md): The complete contract from the client site's perspective: environment, authentication, content resources, lead submission, assets, the cache-invalidation endpoint your site must expose, fixed vocabularies, limits, errors, and worked examples. Read this first.
- [OpenAPI 3.1 description](https://www.casadigital.pt/api/v1/openapi.json): Every endpoint, request body and response, machine-readable. Use it for codegen or to drive HTTP calls directly.
- [JSON Schema per content resource](https://www.casadigital.pt/api/content-schema): The payload shapes on their own, for generating or validating local types instead of hand-copying fields.

## Endpoint reference

- [Site API reference (Markdown)](https://www.casadigital.pt/api/v1/docs): Endpoint-by-endpoint reference with full field tables.
- [Site API reference (HTML)](https://www.casadigital.pt/api-docs): The same reference for human readers.

## Optional

- [Everything in one file](https://www.casadigital.pt/llms-full.txt): The integration contract plus the JSON Schemas, for agents that prefer a single fetch.
- [Content format reference (HTML)](https://www.casadigital.pt/docs/content-api): How the platform stores content internally. Background only — a client site never sees these shapes.
- [The product behind the API](https://www.casadigital.pt/produtos/website-cms-crm): What tenants get for their subscription: a website, the content backoffice, the CRM and lead notifications.