Para programadores e integradores
Uma API de marcações, e um servidor MCP por cima.
Tudo o que a área de gestão faz passa pela mesma API pública: disponibilidade, marcações, clientes, serviços, recursos, horários, pagamentos. Não há uma API de segunda.
A descrição OpenAPI completa é servida em aberto, sem conta e sem formulário.
O que ler primeiro
A autenticação é um token no cabeçalho Authorization. Cada chave tem permissões explícitas, e uma chave pública de widget só faz o que um visitante tem direito a fazer.
- https://sutempo.com/openapi.json : a descrição OpenAPI completa da API, servida em /v1
- https://sutempo.com/.well-known/platform-capabilities.json : o manifesto de capacidades deste deployment
- https://sutempo.com/llms.txt : o mesmo resumo, para um assistente
- https://sutempo.com/console : a consola que emite as chaves de API, depois de entrar
O caminho mais curto até uma marcação
Ler a disponibilidade, reservar o horário enquanto o pagamento decorre, e confirmar depois. O horário nunca é calculado no cliente: o servidor só propõe inícios posteriores ao seu relógio, e uma reserva temporária impede que dois clientes fiquem com o mesmo horário.
curl -H "Authorization: Bearer $SUTEMPO_KEY" \
"https://sutempo.com/v1/business-tenants/$TENANT/availability?serviceId=$SERVICE&from=2026-10-01"
curl -X POST -H "Authorization: Bearer $SUTEMPO_KEY" \
-H "Content-Type: application/json" -H "Idempotency-Key: $(uuidgen)" \
-d '{"serviceId":"...","startsAt":"2026-10-01T09:00:00Z"}' \
"https://sutempo.com/v1/business-tenants/$TENANT/appointments/hold"O servidor MCP
O pacote @platform/mcp-server expõe a configuração de um negócio como ferramentas para um agente. O contrato obriga a pré-visualizar antes de aplicar: um agente lê a configuração, propõe uma alteração, mostra os efeitos, e só depois aplica.
Não é uma formalidade. A pré-visualização devolve a lista de alterações destrutivas, e a aplicação é recusada se a configuração mudou entre as duas chamadas.
- describe_capabilities, list_business_tenants, list_tenant_modules: o que este deployment sabe fazer
- get_current_blueprint, get_blueprint_version: o estado actual e a sua versão
- preview_blueprint_changes e depois apply_blueprint_changes: propor e aplicar
- schedule_group_sessions, cancel_group_session: as sessões de grupo
- get_translation_status, set_translation_override: os idiomas da página pública
Integrar a marcação num site
Dois caminhos, conforme o que estiver a construir. O widget integrável entra num site existente com uma chave pública e herda o idioma da página. O SDK JavaScript e a API por baixo permitem construir todo o percurso à sua maneira, pagamento incluído.
Nos dois casos, os pagamentos vão para a conta Stripe do negócio, nunca para uma conta intermédia.
Perguntas frequentes
A API é paga à parte?
Não. O acesso à API segue a subscrição do negócio. Não há tarifa de programador nem funcionalidades em falta face à área de gestão.
Como obtenho uma chave?
Na consola de programador, depois de entrar na conta do negócio. As chaves criam-se, rodam-se e revogam-se pela API tal como pela consola.
As escritas são idempotentes?
Sim, aceitam um cabeçalho Idempotency-Key, o que torna seguro repetir depois de uma falha de rede.
O servidor MCP pode alterar um negócio sem controlo?
Não. O contrato obriga a chamar a pré-visualização antes de aplicar, e a aplicação falha se a configuração mudou entretanto.
Há webhooks?
Sim. O envio de webhooks faz parte da plataforma e configura-se como o resto, pela API.
Comece de graça.
Criar contaO Solo é gratuito e não pede cartão. Établissement e Membership têm 30 dias de experiência, e no fim o negócio volta ao Solo sem perder nada.