Visão Geral da API
A API do WhenToMeet fornece acesso programático para criar e gerenciar eventos de agendamento. Esta página cobre pré-requisitos e o essencial—para documentação completa de endpoints, esquemas de solicitação/resposta e testes interativos, visite a Referência da API.
Início Rápido
1. Obter Acesso à API
A API requer uma assinatura Plus ou Plus Lifetime.
2. Criar uma Chave de API
- Acesse Configurações → Chaves de API
- Clique em "Criar Chave de API"
- Dê um nome descritivo (ex: "Servidor de Produção")
- Copie a chave imediatamente – ela é mostrada apenas uma vez
- Armazene-a com segurança (variáveis de ambiente, gerenciador de segredos, etc.)
3. Explorar a API
Visite a Referência da API para:
- Navegar por todos os endpoints disponíveis
- Ver esquemas de solicitação/resposta
- Testar chamadas de API interativamente
- Ver exemplos de código
Autenticação
Todas as solicitações requerem um token Bearer:
Authorization: Bearer sk_sua_chave_api_aqui
Segurança da Chave de API
✅ FAZER:
- Armazenar chaves em variáveis de ambiente ou gerenciadores de segredos
- Usar chaves diferentes para dev/staging/produção
- Rotacionar chaves periodicamente
- Revogar chaves comprometidas imediatamente
❌ NÃO FAZER:
- Fazer commit de chaves no controle de versão
- Compartilhar chaves por e-mail ou chat
- Incorporar chaves em código do lado do cliente
- Reutilizar chaves em várias aplicações
Limites de Taxa
| Nível | Limite | Janela |
|---|---|---|
| Gratuito | 32 solicitações | Total vitalício |
| Plus | 1.000 solicitações | Por hora (contínuo) |
| Plus Lifetime | 1.000 solicitações | Por hora (contínuo) |
Cabeçalhos de Limite de Taxa
As respostas incluem:
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 1736956800
Quando limitado (resposta 429):
- Implementar backoff exponencial
- Verificar
X-RateLimit-Resetpara o tempo de reinício - Monitorar
X-RateLimit-Remainingpara limitar proativamente
Precisa de Ajuda?
- Referência da API - Documentação completa com exemplos interativos
- Configurações de Chaves de API - Gerencie suas chaves
- Todos os Documentos - Guias de usuário e tutoriais
- Suporte - Entre em contato