GET /v3/versiones/bestmatch

Búsqueda de versión que mejor encaja según los parámetros suministrados. Este es tu mejor amigo para evitar mapeo de marca y modelo, entre tus valores y las marcas/modelos en Autocosmos, antes de publicar un auto.

Request

Query parameters

Name	Type	Constraints	Example	Descripción
make	string	Required	"ferrari"	Valor de búsqueda para marca; soportado id, api-url, api-url-path, nombre, codename.
model	string	Required	"360"	Valor de búsqueda para modelo; soportado id, api-url, api-url-path, nombre completo, parte del nombre, codename.
bodystyle	string		"coupe"	Valor de búsqueda para carrocería; soportado id, api-url, api-url-path, nombre, codename.
trim	string		"f1"	Valor de búsqueda para versión; soportado id, api-url, api-url-path, nombre completo, parte del nombre, codename. Es posible buscar una versión sin valorizar el parámetro trim y valorizando las características conocidas.
year	integer (int32)		2009	Año fabricación/circulación de las versión. Si no especificado, sólo se tomarán en cuenta versiones actualmente disponibles en el mercado de autos nuevos.
transmissionType	string		"a"	Tipo de transmisión; suportado 'A','Automatico','M','Manual'.
displacement	string		"5"	Cilindrada del motor a combustión (solo autos que tengan un motor de combustión). Es suficiente expresar solo el valor sin unidad de medida y redondeado (Ej: cilindrara-real=2755cc displacement=2.8 o displacement=2.8L).
power	string		"340cv"	Potencia del motor a combustión o eléctrico. Es suficiente expresar solo el valor sin unidad de medida (Ej: power=204 o power=204cv).
fuelType	string		"gasolina"	Valor de búsqueda para el tipo de propulsión; soportado id, api-url, api-url-path, nombre completo, codename.

Responses

HTTP-StatusCode 200

VersionMatch when Accept: application/json text/json

{
  "Make": "/v3/marcas/123",
  "Model": "/v3/modelos/4567",
  "Trim": "/v3/versiones/345678",
  "FuelType": "gasolina",
  "TransmisionType": "Automática",
  "Match": {
    "VersionYear": null,
    "Propulsion": "gasolina",
    "Transmision": "Automática",
    "Potencia": null,
    "Cilindrada": null,
    "Marca": "Ferrari",
    "Modelo": "F360",
    "Nombre": "Modena F1",
    "Codename": "modena-f1",
    "Carroceria": "Coupé",
    "Segmento": "C",
    "_links": {
      "href": "/v3/versiones/345678"
    }
  },
  "Candidates": [
    {
      "VersionYear": null,
      "Propulsion": "gasolina",
      "Transmision": "Automática",
      "Potencia": null,
      "Cilindrada": null,
      "Marca": "Ferrari",
      "Modelo": "F360",
      "Nombre": "Modena F1",
      "Codename": "modena-f1",
      "Carroceria": "Coupé",
      "Segmento": "C",
      "_links": {
        "href": "/v3/versiones/345678"
      }
    }
  ]
}

HTTP-StatusCode 400

ValidationProblemDetails Content-Type: application/problem+json

{
  "Errors": {
    "_": [
      "entry problem1",
      "entry problem2"
    ],
    "property1": [
      "problem 1"
    ]
  },
  "Type": "https://httpstatuses.com/400",
  "Title": "Validación de información esperada fallida",
  "Status": 400,
  "Detail": "Alguna información contiene valores no validos.",
  "Instance": "/v3/somewhere",
  "Extensions": {}
}