TilenTilen
Entrar
Voltar

Desenvolvedores

Chaves de API, endpoints e documentacao

Chaves de API

Placeholder

Use uma chave real somente dentro do painel

Esta pagina publica mostra apenas exemplos seguros. As chaves reais continuam visiveis somente para usuarios autenticados em /dashboard/desenvolvedores.

shell
Authorization: Bearer tvk_YOUR_API_KEY
Publico

Nenhum token real e carregado nesta rota.

Todos os exemplos usam placeholders como tvk_YOUR_API_KEY.

O teste interativo fica restrito ao painel autenticado.

Embed da agenda

Pro

Incorpore uma agenda em outro sistema via iframe. Uma chave dedicada e preparada automaticamente.

O embed da agenda está disponível nos planos pagos.

https://tilen.cc/embed/agenda/660e8400-e29b-41d4-a716-446655440000?embedToken=tvk_YOUR_EMBED_API_KEY&view=week
html
<iframe src="https://tilen.cc/embed/agenda/660e8400-e29b-41d4-a716-446655440000?embedToken=tvk_YOUR_EMBED_API_KEY&view=week" width="100%" height="920" style="border:0;border-radius:16px;overflow:hidden" loading="lazy"></iframe>

Resumo

Agenda

Consultas Gerais

Ana Silva · consultas-gerais

O que o embed entrega

  • Calendario com visual do painel
  • Eventos filtrados pela API Key
  • Detalhes ao clicar em um evento
  • Protecao: sem chave, sem acesso

Use uma API Key dedicada para embeds. Como o iframe envia a chave no request, evite reusar em outros sistemas.

Autenticacao

Endpoints autenticados exigem o header Authorization com sua API Key:

shell
Authorization: Bearer tvk_YOUR_API_KEY
PublicoSem autenticacao
API KeyHeader obrigatorio

Nunca exponha sua API Key em codigo client-side. Use chaves dedicadas para embeds e mantenha o uso restrito a integracoes confiaveis.

Integrações

O Tilen expõe um servidor MCP em https://tilen.cc/api/mcp. A configuração é uma API Key e nada mais: o agente descobre as ferramentas sozinho. Disponível em todos os planos, incluindo o Free, dentro dos mesmos limites da API.

json
{
  "mcpServers": {
    "tilen": {
      "url": "https://tilen.cc/api/mcp",
      "headers": {
        "Authorization": "Bearer tvk_SUA_API_KEY"
      }
    }
  }
}

Ferramentas disponíveis

  • list_agendasdescobre o agendaId da conta
  • list_servicesserviços com duração e preço
  • check_availabilityhorários livres de uma data
  • create_appointmentcria o agendamento
  • get_appointmentconsulta um agendamento
  • reschedule_appointmentmove para outro horário
  • cancel_appointmentcancela e libera o horário

AI Mode

Adicione ?aimode=1 a qualquer endpoint para receber respostas em text/markdown otimizadas para agentes e automacoes.

Sessao autenticada

shell
GET https://tilen.cc/api/agendas?aimode=1
GET https://tilen.cc/api/agendamentos?aimode=1
GET https://tilen.cc/api/dashboard/stats?aimode=1

API externa

shell
GET https://tilen.cc/api/v1/agenda/{userId}/{slug}?aimode=1
GET https://tilen.cc/api/v1/agendas/{agendaId}/rules?aimode=1
GET https://tilen.cc/api/v1/appointments?aimode=1

Endpoints

Agenda para os exemplos
userId:550e8400-e29b-41d4-a716-446655440000
slug:consultas-gerais
agendaId:660e8400-e29b-41d4-a716-446655440000
Agenda Pública

Endpoints públicos para consultar agendas, serviços e horários disponíveis.

Campos de agendamento

Defina informações reutilizáveis e marcadores booleanos que podem ser preenchidos em agendamentos futuros ou passados.

Regras de Agenda

Defina e consulte regras avançadas de disponibilidade por agenda usando API Key.

Agendamentos

CRUD completo de agendamentos. Requer autenticação via API Key.

Webhooks

Receba appointment.created, appointment.updated e appointment.cancelled assim que a agenda muda, qualquer que seja a origem.

Codigos de resposta

200OKRequisição processada com sucesso
201CreatedRecurso criado com sucesso
400Bad RequestDados inválidos ou ausentes
401UnauthorizedAPI Key ausente ou inválida
403ForbiddenSem permissão para este recurso
404Not FoundRecurso não encontrado
409ConflictConflito — recurso já existe ou horário indisponível