GET v1/ads/{adid}/specs

Retorna as Especificações de um anúncio através do código informado

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)
  • BadRequest (400)
  • Unauthorized (401)
  • Forbidden (403)
  • NotFound (404)

Request Information

URL Parameters

The parameters must be in the request URL.

NameDescriptionTypeAdditional Information
adIdAd identification code in the Mercado Máquinas.integerRequired

Request body parameters

These parameters must be in the request Body.

Description not available.

Response Information

Resource Description

AdSpecResponse array Returns the specifications of an Ad according to the identification code in the Mercado Máquinas.

NameDescriptionTypeAdditional Information
NameSpecification Unique Namestring
GroupSpecification Group Namestring
DescriptionSpecification Descriptionstring
DataTypeSpecification data typestring
IsRequiredIdentifies if the Specification is requiredboolean
UnitOfMeasurementSpecification unit of measurementstring
IsListIndicates whether the specification is a list with fixed valuesboolean
ListOfValuesAccepted values for the specification when it is a liststring array

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.
[
  {
    "name": "numero-de-serie",
    "group": "Informações Gerais",
    "description": "Número de série é o código que identifica máquinas, peças e acessórios e obter informações adicionais no fabricante.",
    "dataType": "text",
    "isRequired": false,
    "unitOfMeasurement": null,
    "isList": false,
    "listOfValues": null
  },
  {
    "name": "cor-predominante",
    "group": "Informações Gerais",
    "description": "Informar a cor predominante do equipamento.",
    "dataType": "text",
    "isRequired": false,
    "unitOfMeasurement": null,
    "isList": true,
    "listOfValues": [
      "amarelo",
      "azul",
      "indefinida",
      "laranja",
      "marron"
    ]
  },
  {
    "name": "utilizacao-horas",
    "group": "Utilização",
    "description": "Quantidade de horas completas trabalhadas. (Ex.: 2.350,8 horas digite apenas 2350)",
    "dataType": "number",
    "isRequired": true,
    "unitOfMeasurement": "h",
    "isList": false,
    "listOfValues": null
  }
]

text/html

[{"name":"numero-de-serie","group":"Informações Gerais","description":"Número de série é o código que identifica máquinas, peças e acessórios e obter informações adicionais no fabricante.","dataType":"text","isRequired":false,"unitOfMeasurement":null,"isList":false,"listOfValues":null},{"name":"cor-predominante","group":"Informações Gerais","description":"Informar a cor predominante do equipamento.","dataType":"text","isRequired":false,"unitOfMeasurement":null,"isList":true,"listOfValues":["amarelo","azul","indefinida","laranja","marron"]},{"name":"utilizacao-horas","group":"Utilização","description":"Quantidade de horas completas trabalhadas. (Ex.: 2.350,8 horas digite apenas 2350)","dataType":"number","isRequired":true,"unitOfMeasurement":"h","isList":false,"listOfValues":null}]