GET v1/ad-models/{category}/{make}/{model}
Recurso para verificar se o modelo (Categoria/Fabricante/Modelo) informado existe no Mercado Máquinas
Requer Autorização
Para realizar a autorização, é necessário enviar as credenciais de autenticação usando o cabeçalho de autorização.
O cabeçalho de autorização é construído como se segue:
- O nome de usuário e a senha são combinadas em uma string "usuário:senha"
- A seqüência resultante literal é então codificado em Base64
- O método de autorização seguido da palavra "Basic" é, então, colocado antes da seqüência codificada.
Authorization: Basic QWxhZGRpbjphYnJhLWRlLXPDqXNhbW8=
Códigos de Resposta
- OK (200)
- Unauthorized (401)
- NotFound (404)
Informações da Requisição
Parâmetros da URL
Os parâmetros devem ser informados na URL da requisição.
Nome | Descrição | Tipo | Informações adicionais |
---|---|---|---|
Category | Categoria da Máquina/Equipamento do anúncio | string | Obrigatório |
Make | Fabricante da Máquina/Equipamento do anúncio | string | Obrigatório |
Model | Modelo da Máquina/Equipamento do anúncio | string | Obrigatório |
Parâmetros do corpo da requisição
Estes parâmetros devem ser informados no corpo da requisição.
Descrição não disponível.
Informações da Resposta
Descrição do recurso
AdModelResponse array
Nome | Descrição | Tipo | Informações adicionais |
---|---|---|---|
Category | Categoria da Máquina/Equipamento do anúncio | string | |
Make | Fabricante da Máquina/Equipamento do anúncio | string | |
Model | Modelo da Máquina/Equipamento do anúncio | string | |
StartYear | Ano de início da fabricação do Modelo da Máquina/Equipamento do anúncio | integer | |
EndYear | Ano de término da fabricação do Modelo da Máquina/Equipamento do anúncio | integer |
Formatos da Resposta
application/json, text/json
Observações:
- No formato Json, os nomes dos parâmetros seguem o padrão camelCase, ou seja, sempre são iniciados com letras minúsculas.
{ "category": "Escavadeira", "make": "Case", "model": "CX220", "startYear": 1996, "endYear": 2019 }
text/html
{"category":"Escavadeira","make":"Case","model":"CX220","startYear":1996,"endYear":2019}
application/xml, text/xml
<AdModelResponse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Category>Escavadeira</Category> <Make>Case</Make> <Model>CX220</Model> <StartYear>1996</StartYear> <EndYear>2019</EndYear> </AdModelResponse>