GET v1/ad-models/{category}/{make}/{model}

Recurso para verificar se o modelo (Categoria/Fabricante/Modelo) informado existe no Mercado Máquinas

Requires Authorization

To perform authorization, you must submit the authentication credentials using the HTTP Basic authorization header.
The authorization header is constructed as follows:

  1. The username and password are combined into a string "user:password"
  2. The resulting literal string is then encoded in Base64
  3. The authorization method followed by the word "Basic" is then placed before the coded sequence.
For example, if the user is 'Aladdin' and the password is 'open-sesame' then the header should be:
Authorization: Basic QWxhZGRpbjpvcGVuLXNlc2FtZQ==

Response Codes

  • OK (200)
  • Unauthorized (401)
  • NotFound (404)

Request Information

URL Parameters

The parameters must be in the request URL.

NameDescriptionTypeAdditional Information
CategoryCategoria da Máquina/Equipamento do anúnciostringObrigatório
MakeFabricante da Máquina/Equipamento do anúnciostringObrigatório
ModelModelo da Máquina/Equipamento do anúnciostringObrigatório

Request body parameters

These parameters must be in the request Body.

Description not available.

Response Information

Resource Description

AdModelResponse array

NameDescriptionTypeAdditional Information
CategoryCategoria da Máquina/Equipamento do anúnciostring
MakeFabricante da Máquina/Equipamento do anúnciostring
ModelModelo da Máquina/Equipamento do anúnciostring
StartYearAno de início da fabricação do Modelo da Máquina/Equipamento do anúnciointeger
EndYearAno de término da fabricação do Modelo da Máquina/Equipamento do anúnciointeger

Response Formats

application/json, text/json

Notes:

  • In Json format, the parameter names follow the camelCase pattern, that is, they always start with lowercase letters.
{
  "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>