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.

Agenda

Visual

API Key do embed

Exemplo publico. Gere uma chave real dentro do painel.

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.

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.

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