Rotas Adicionais
Introdução
Esta documentação detalha as rotas adicionais disponíveis na API. Cada rota é descrita com seus respectivos endpoints, métodos HTTP, e exemplos de resposta. Estas rotas fornecem acesso a informações complementares que são úteis para a gestão de eventos, incluindo como os clientes conheceram o serviço, tipos de eventos, locais de eventos e vendedores.
Rotas Disponíveis
| Método | URL | Ação | Descrição |
|---|---|---|---|
| GET | /api/v1/howmet | Listar | Lista todos os registros de como conheceu |
| GET | /api/v1/eventlocation | Listar | Lista todos os locais de eventos |
| GET | /api/v1/eventtype | Listar | Lista todos os tipos de eventos |
| GET | /api/v1/seller | Listar | Lista todos os vendedores |
| POST | /api/v1/calendar | Cadastrar | Cadastra um compromisso na agenda |
Detalhes das Rotas
1. Como Conheceu
Endpoint: /api/v1/howmet
Método: GET
Retorna uma lista de todas as formas como os clientes conheceram o serviço.
Exemplo de Resposta:
[
{
"id": "1",
"nome": "Indicação de Fornecedor/Parceiro"
},
{
"id": "2",
"nome": "Pesquisa na Internet"
},
// ... outros itens
]2. Locais de Eventos
Endpoint: /api/v1/eventlocation
Método: GET
Retorna uma lista de todos os locais de eventos cadastrados.
Exemplo de Resposta:
[
{
"id": "11",
"nome": "Espaço MeEventos",
"cep": "30520540",
"endereco": "Av. Dom Pedro II",
"numero": "2654",
"bairro": "Caiçaras",
"cidade": "Belo Horizonte",
"estado": "MG"
},
// ... outros locais
]3. Tipos de Eventos
Endpoint: /api/v1/eventtype
Método: GET
Retorna uma lista de todos os tipos de eventos disponíveis.
Exemplo de Resposta:
[
{
"id": "35",
"nome": "Almoço"
},
{
"id": "4",
"nome": "Aniversário"
},
// ... outros tipos
]4. Vendedores
Endpoint: /api/v1/seller
Método: GET
Retorna uma lista de todos os vendedores cadastrados.
Exemplo de Resposta:
[
{
"id": "61",
"nome": "Thalles Brandão"
},
{
"id": "95",
"nome": "Jonathan Brambati"
}
]5. Agenda
Endpoint: /api/v1/calendar
Método: POST
Cadastra um compromisso na agenda
Exemplo de Cadastro:
[
{
"nome": "Reunião com cliente",
"responsavel": 2,
"idcat": 1,
"datahora": "2024-12-25 14:30:00",
"datahorafim": "2024-12-25 16:00:00",
"localcomp": "Escritório Principal",
"anotacoes": "Reunião para discussão do projeto",
"idcli": 15,
"extra1": "orcamento"
}
]Observações Finais
Para as rotas que utilizam o método GET para recuperar informações. Não são necessários parâmetros adicionais para estas chamadas. As respostas são sempre no formato JSON, facilitando a integração com diversos sistemas e linguagens de programação.