API do Baduhub
Bem-vindo à documentação oficial da API do Baduhub. Nossa API RESTful permite que você integre facilmente suas aplicações com nossa plataforma, automatize processos e gerencie seus dados de forma programática.
A URL base para todas as requisições é:
https://api.baduhub.com/v1
Autenticação
Todas as requisições à API devem ser autenticadas usando um Bearer Token. Você pode gerar este token nas configurações da sua conta no painel do Baduhub.
Envie o token no cabeçalho Authorization de cada requisição:
Authorization: Bearer SEU_TOKEN_API
Usuários
Obter detalhes do usuário
Retorna as informações do usuário autenticado.
GET
/user
{
"data": {
"id": 1,
"name": "João Silva",
"email": "[email protected]",
"created_at": "2026-01-15T10:00:00Z"
}
}
Leads
Criar um novo lead
Adiciona um novo lead à sua base de contatos.
POST
/leads
Parâmetros
| Campo | Tipo | Descrição |
|---|---|---|
name |
string | Nome completo do lead (Obrigatório) |
email |
string | E-mail do lead (Obrigatório, único) |
phone |
string | Telefone para contato (Opcional) |
Exemplo de Requisição
{
"name": "Maria Oliveira",
"email": "[email protected]",
"phone": "+5511999998888"
}
Produtos
Listar produtos
Retorna uma lista paginada dos seus produtos cadastrados.
GET
/products
Erros
A API utiliza códigos de status HTTP padrão para indicar o sucesso ou falha de uma requisição.
| Código | Descrição |
|---|---|
| 200 OK | A requisição foi bem-sucedida. |
| 201 Created | O recurso foi criado com sucesso. |
| 400 Bad Request | A requisição é inválida (ex: parâmetros faltando). |
| 401 Unauthorized | Token de autenticação inválido ou ausente. |
| 404 Not Found | O recurso solicitado não foi encontrado. |
| 429 Too Many Requests | Você excedeu o limite de requisições da API. |
| 500 Internal Server Error | Erro interno no servidor. Tente novamente mais tarde. |