Rotas sem versão
As rotas /api/managers, gêmeas das /api/v1.0/managers, para clientes escritos para a Venddor 1.0.
As rotas de gerentes da API 1.0 existem também sem o prefixo de versão: /api/managers no lugar de /api/v1.0/managers. A lógica, a autenticação (HTTP Basic com e-mail:chave_de_api de um administrador, ou Bearer) e os campos são os mesmos descritos em Gerenciar gerentes.
Ao contrário de clientes e grupos, o manager_id já é um inteiro nas duas formas; não há conversão de ids. O que muda é só o caminho. Use a forma sem versão apenas se o seu cliente já foi escrito para ela.
/api/managersAdminListar gerentes de vendas (rota sem versão)
Igual a GET /api/v1.0/managers: Gerenciar gerentes.
/api/managers/{id}AdminConsultar um gerente de vendas (rota sem versão)
Igual a GET /api/v1.0/managers/{id}: Gerenciar gerentes.
Parâmetros de caminho
idstringobrigatóriomanager_id, inteiro./api/managersAdminCriar um gerente de vendas (rota sem versão)
Igual a POST /api/v1.0/managers: Gerenciar gerentes.
/api/managers/{id}AdminAtualizar um gerente de vendas (rota sem versão)
Igual a PUT /api/v1.0/managers/{id}: Gerenciar gerentes.
Parâmetros de caminho
idstringobrigatóriomanager_id, inteiro./api/managers/{id}AdminExcluir um gerente de vendas (não suportado) (rota sem versão)
Igual a DELETE /api/v1.0/managers/{id}: Gerenciar gerentes.
Parâmetros de caminho
idstringobrigatóriomanager_id, inteiro.Exemplo de requisição
curl -u "$EMAIL:$API_KEY" "$BASE_URL/api/managers?status=A&items_per_page=10"Resposta
{
"managers": [
{ "manager_id": "30", "user_id": "fb345fc1-599a-4b4d-9fb0-93d1e7196cc0", "name": "Ana Paula Ribeiro", "status": "A", "internal_code": "GER-SUL-01" }
],
"search": { "page": 1, "items_per_page": 10, "total_items": 13 },
"success": true,
"message": ""
}Erros
São os de Gerenciar gerentes.
| Status | Quando | Corpo |
|---|---|---|
| 401 | Sem credenciais ou chave inválida | {"message":"Invalid credentials","status":401} |
| 403 | Usuário que não é administrador | {"message":"Forbidden: admin scope required","status":403} |
| 404 | DELETE (não suportado) | {"message":"Delete not supported for managers","status":404} |