{ "openapi": "3.0.1", "info": { "title": "Atucosmos API", "description": "API publica que permite gestionar agencia, publicaciones y acceder a la información tecnica de nuestro catalogo.", "contact": { "email": "developers@autocosmos.com" }, "version": "v3" }, "paths": { "/v3/agencias": { "get": { "tags": [ "Agencias" ], "summary": "Lista de Agencias.", "parameters": [ { "name": "operador", "in": "query", "description": "(opcional) Email de uno de los operadores de la Agencia", "schema": { "type": "string", "format": "email" } } ], "responses": { "200": { "description": "Lista de agencias habilitada para la app.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Agencias" }, "examples": { "eg_V3.Models.Agencias": { "$ref": "#/components/examples/eg_V3.Models.Agencias" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Agencias" }, "examples": { "eg_V3.Models.Agencias": { "$ref": "#/components/examples/eg_V3.Models.Agencias" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Agencias" }, "examples": { "eg_V3.Models.Agencias": { "$ref": "#/components/examples/eg_V3.Models.Agencias" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.AgenciasRef" }, "examples": { "eg_V3.Models.AgenciasRef": { "$ref": "#/components/examples/eg_V3.Models.AgenciasRef" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } }, "post": { "tags": [ "Agencias" ], "summary": "Invita una Agencia a registrarse en Autocosmos. Se enviará un email a la dirección especifícada en la propiedad AdminMail. \r\nQuién lo reciba, deberá seguir la indicaciones para registrar su agencia en Autocosmos.\r\nSi tu App está suscripta a las notificaciones (endpoint AppNotificaciones), recibirás un webhook cuando el usuario se registre.\r\nSi no estas suscripto podrás consultar el estado de la invitación usando la Location, que te devolvimos en el header, con el HTTP-Method OPTIONS o GET.", "requestBody": { "description": "La Agencia a invitar", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.AgenciaCreate" }, "examples": { "eg_V3.Models.AgenciaCreate": { "$ref": "#/components/examples/eg_V3.Models.AgenciaCreate" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.AgenciaCreate" }, "examples": { "eg_V3.Models.AgenciaCreate": { "$ref": "#/components/examples/eg_V3.Models.AgenciaCreate" } } } } }, "responses": { "202": { "description": "Invitación aceptada, se envió un e-mail a la dirección que será el administrador de la cuenta.", "headers": { "Location": { "description": "URI agencia.", "schema": { "type": "string", "format": "uri" } } } }, "409": { "description": "El e-mail que nos proporcionaste ya está registrado en Autocosmos; el administrador deberá contactarse con nuestro SAC.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/agencias/{adminmail}": { "get": { "tags": [ "Agencias" ], "summary": "Información de la agencia.", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email del administrador de la cuenta.", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Agencia" }, "examples": { "eg_V3.Models.Agencia": { "$ref": "#/components/examples/eg_V3.Models.Agencia" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Agencia" }, "examples": { "eg_V3.Models.Agencia": { "$ref": "#/components/examples/eg_V3.Models.Agencia" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Agencia" }, "examples": { "eg_V3.Models.Agencia": { "$ref": "#/components/examples/eg_V3.Models.Agencia" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.AgenciaRef" }, "examples": { "eg_V3.Models.AgenciaRef": { "$ref": "#/components/examples/eg_V3.Models.AgenciaRef" } } } } }, "404": { "description": "La agencia, para tu app, no existe." } } }, "put": { "tags": [ "Agencias" ], "summary": "Modifica los datos de una Agencia.", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } } ], "requestBody": { "description": "Nueva información de la Agencia/Concesionaria", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.AgenciaEdit" }, "examples": { "eg_V3.Models.AgenciaEdit": { "$ref": "#/components/examples/eg_V3.Models.AgenciaEdit" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.AgenciaEdit" }, "examples": { "eg_V3.Models.AgenciaEdit": { "$ref": "#/components/examples/eg_V3.Models.AgenciaEdit" } } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Agencia" }, "examples": { "eg_V3.Models.Agencia": { "$ref": "#/components/examples/eg_V3.Models.Agencia" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Agencia" }, "examples": { "eg_V3.Models.Agencia": { "$ref": "#/components/examples/eg_V3.Models.Agencia" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Agencia" }, "examples": { "eg_V3.Models.Agencia": { "$ref": "#/components/examples/eg_V3.Models.Agencia" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.AgenciaRef" }, "examples": { "eg_V3.Models.AgenciaRef": { "$ref": "#/components/examples/eg_V3.Models.AgenciaRef" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } }, "403": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } } } } } } }, "/v3/agencias/{adminmail}/desasociar": { "patch": { "tags": [ "Agencias" ], "summary": "Desasocia una agencia de la app. La agencia podrá seguir usando su cuenta en Autocosmos, eventualmente recuperando sus publicaciones que quedarán suspendidas.", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } } ], "responses": { "204": { "description": "Agencia desasociada de tu app." }, "403": { "description": "Tu app no tiene permiso sobre la agencia.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } } } } } } }, "/v3/agencias/{adminmail}/productos": { "get": { "tags": [ "Agencias" ], "summary": "Estado del paquete de publicaciones de una agencia.", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.AgenciaProductos" }, "examples": { "eg_V3.Models.AgenciaProductos": { "$ref": "#/components/examples/eg_V3.Models.AgenciaProductos" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.AgenciaProductos" }, "examples": { "eg_V3.Models.AgenciaProductos": { "$ref": "#/components/examples/eg_V3.Models.AgenciaProductos" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.AgenciaProductos" }, "examples": { "eg_V3.Models.AgenciaProductos": { "$ref": "#/components/examples/eg_V3.Models.AgenciaProductos" } } } } }, "404": { "description": "La agencia, para tu app, no existe." }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/appnotificaciones": { "get": { "tags": [ "AppNotificaciones" ], "summary": "Lista de topics disponibles y configurados para tu app.", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.AppWebhooks" }, "examples": { "eg_V3.Models.AppWebhooks": { "$ref": "#/components/examples/eg_V3.Models.AppWebhooks" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.AppWebhooks" }, "examples": { "eg_V3.Models.AppWebhooks": { "$ref": "#/components/examples/eg_V3.Models.AppWebhooks" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.AppWebhooks" }, "examples": { "eg_V3.Models.AppWebhooks": { "$ref": "#/components/examples/eg_V3.Models.AppWebhooks" } } } } } } } }, "/v3/appnotificaciones/{topic}": { "get": { "tags": [ "AppNotificaciones" ], "summary": "Configuración webhook.", "parameters": [ { "name": "topic", "in": "path", "description": "Topic buscado.", "required": true, "schema": { "maxLength": 80, "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.AppWebhook" }, "examples": { "eg_V3.Models.AppWebhook": { "$ref": "#/components/examples/eg_V3.Models.AppWebhook" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.AppWebhook" }, "examples": { "eg_V3.Models.AppWebhook": { "$ref": "#/components/examples/eg_V3.Models.AppWebhook" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.AppWebhook" }, "examples": { "eg_V3.Models.AppWebhook": { "$ref": "#/components/examples/eg_V3.Models.AppWebhook" } } } } }, "404": { "description": "Webhook no disponible o nunca fué configurado." } } }, "post": { "tags": [ "AppNotificaciones" ], "summary": "Crea la configuración del webhook.", "parameters": [ { "name": "topic", "in": "path", "description": "Topic para configurar", "required": true, "schema": { "maxLength": 80, "type": "string" } } ], "requestBody": { "description": "Configuración del webhook.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.AppWebhookUpsert" }, "examples": { "eg_V3.Models.AppWebhookUpsert": { "$ref": "#/components/examples/eg_V3.Models.AppWebhookUpsert" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.AppWebhookUpsert" }, "examples": { "eg_V3.Models.AppWebhookUpsert": { "$ref": "#/components/examples/eg_V3.Models.AppWebhookUpsert" } } } } }, "responses": { "201": { "description": "Created", "headers": { "Location": { "description": "URI del webhook.", "schema": { "type": "string", "format": "uri" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.AppWebhook" }, "examples": { "eg_V3.Models.AppWebhook": { "$ref": "#/components/examples/eg_V3.Models.AppWebhook" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.AppWebhook" }, "examples": { "eg_V3.Models.AppWebhook": { "$ref": "#/components/examples/eg_V3.Models.AppWebhook" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.AppWebhook" }, "examples": { "eg_V3.Models.AppWebhook": { "$ref": "#/components/examples/eg_V3.Models.AppWebhook" } } } } }, "403": { "description": "Topic no disponible.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } } } }, "409": { "description": "La configuración del webhook ya fue creada (usa el PUT).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } }, "put": { "tags": [ "AppNotificaciones" ], "summary": "Modificación de la configuración del webhook.", "parameters": [ { "name": "topic", "in": "path", "description": "Topic configurado.", "required": true, "schema": { "maxLength": 80, "type": "string" } } ], "requestBody": { "description": "Configuración del webhook.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.AppWebhookUpsert" }, "examples": { "eg_V3.Models.AppWebhookUpsert": { "$ref": "#/components/examples/eg_V3.Models.AppWebhookUpsert" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.AppWebhookUpsert" }, "examples": { "eg_V3.Models.AppWebhookUpsert": { "$ref": "#/components/examples/eg_V3.Models.AppWebhookUpsert" } } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.AppWebhook" }, "examples": { "eg_V3.Models.AppWebhook": { "$ref": "#/components/examples/eg_V3.Models.AppWebhook" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.AppWebhook" }, "examples": { "eg_V3.Models.AppWebhook": { "$ref": "#/components/examples/eg_V3.Models.AppWebhook" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.AppWebhook" }, "examples": { "eg_V3.Models.AppWebhook": { "$ref": "#/components/examples/eg_V3.Models.AppWebhook" } } } } }, "404": { "description": "Webhook no disponible o nunca fué configurado." }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } }, "delete": { "tags": [ "AppNotificaciones" ], "summary": "Elimina la configuración del webhook.", "parameters": [ { "name": "topic", "in": "path", "description": "Topic configurado.", "required": true, "schema": { "maxLength": 80, "type": "string" } } ], "responses": { "204": { "description": "Webhook eliminado." }, "404": { "description": "Webhook no disponible o nunca fué configurado." } } } }, "/v3/carrocerias": { "get": { "tags": [ "Carrocerias" ], "summary": "Lista carrocerías.", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Carrocerias" }, "examples": { "eg_V3.Models.Carrocerias": { "$ref": "#/components/examples/eg_V3.Models.Carrocerias" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Carrocerias" }, "examples": { "eg_V3.Models.Carrocerias": { "$ref": "#/components/examples/eg_V3.Models.Carrocerias" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Carrocerias" }, "examples": { "eg_V3.Models.Carrocerias": { "$ref": "#/components/examples/eg_V3.Models.Carrocerias" } } } } } } } }, "/v3/carrocerias/bestmatch": { "get": { "tags": [ "Carrocerias" ], "summary": "Búsqueda de carrocería que mejor encaja según los parámetros de suministrados.", "parameters": [ { "name": "bodystyle", "in": "query", "description": "Valor de búsqueda para carrocería; soportado id, api-url, api-url-path, nombre, codename.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Carroceria" }, "examples": { "eg_V3.Models.Carroceria": { "$ref": "#/components/examples/eg_V3.Models.Carroceria" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Carroceria" }, "examples": { "eg_V3.Models.Carroceria": { "$ref": "#/components/examples/eg_V3.Models.Carroceria" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Carroceria" }, "examples": { "eg_V3.Models.Carroceria": { "$ref": "#/components/examples/eg_V3.Models.Carroceria" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/carrocerias/{id}": { "get": { "tags": [ "Carrocerias" ], "summary": "Carrocería por Id.", "parameters": [ { "name": "id", "in": "path", "description": "Id", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Carroceria" }, "examples": { "eg_V3.Models.Carroceria": { "$ref": "#/components/examples/eg_V3.Models.Carroceria" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Carroceria" }, "examples": { "eg_V3.Models.Carroceria": { "$ref": "#/components/examples/eg_V3.Models.Carroceria" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Carroceria" }, "examples": { "eg_V3.Models.Carroceria": { "$ref": "#/components/examples/eg_V3.Models.Carroceria" } } } } }, "404": { "description": "La carrocería, no existe." } } } }, "/v3/ciudades": { "get": { "tags": [ "Ciudades" ], "summary": "Lista de ciudades de una región (provincia - estado).", "parameters": [ { "name": "region", "in": "query", "description": "Id de la región (opcional si hay q)", "schema": { "type": "integer", "format": "int32" } }, { "name": "q", "in": "query", "description": "Parte del nombre a buscar (opcional si hay region)", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Ciudades" }, "examples": { "eg_V3.Models.Ciudades": { "$ref": "#/components/examples/eg_V3.Models.Ciudades" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Ciudades" }, "examples": { "eg_V3.Models.Ciudades": { "$ref": "#/components/examples/eg_V3.Models.Ciudades" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Ciudades" }, "examples": { "eg_V3.Models.Ciudades": { "$ref": "#/components/examples/eg_V3.Models.Ciudades" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.CiudadesRef" }, "examples": { "eg_V3.Models.CiudadesRef": { "$ref": "#/components/examples/eg_V3.Models.CiudadesRef" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/ciudades/bestmatch": { "get": { "tags": [ "Ciudades" ], "summary": "Búsqueda de la ciudad que mejor encaja según los parámetros suministrados.\r\nEste es tu mejor amigo para evitar mapeo de estados/provincia/región y ciudad, entre tus valores y los registrados en Autocosmos, antes enviarnos una dirección.", "parameters": [ { "name": "state", "in": "query", "description": "Valor de búsqueda para provincia/estado/región; soportado id, api-url, api-url-path, nombre, iso.", "required": true, "schema": { "type": "string" } }, { "name": "city", "in": "query", "description": "Valor de búsqueda para ciudad; soportado id, api-url, api-url-path, nombre completo, parte del nombre.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Ciudad" }, "examples": { "eg_V3.Models.Ciudad": { "$ref": "#/components/examples/eg_V3.Models.Ciudad" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Ciudad" }, "examples": { "eg_V3.Models.Ciudad": { "$ref": "#/components/examples/eg_V3.Models.Ciudad" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Ciudad" }, "examples": { "eg_V3.Models.Ciudad": { "$ref": "#/components/examples/eg_V3.Models.Ciudad" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.CiudadRef" }, "examples": { "eg_V3.Models.CiudadRef": { "$ref": "#/components/examples/eg_V3.Models.CiudadRef" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/ciudades/{id}": { "get": { "tags": [ "Ciudades" ], "summary": "Ciudad por Id.", "parameters": [ { "name": "id", "in": "path", "description": "Id de la Ciudad", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Ciudad" }, "examples": { "eg_V3.Models.Ciudad": { "$ref": "#/components/examples/eg_V3.Models.Ciudad" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Ciudad" }, "examples": { "eg_V3.Models.Ciudad": { "$ref": "#/components/examples/eg_V3.Models.Ciudad" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Ciudad" }, "examples": { "eg_V3.Models.Ciudad": { "$ref": "#/components/examples/eg_V3.Models.Ciudad" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.CiudadRef" }, "examples": { "eg_V3.Models.CiudadRef": { "$ref": "#/components/examples/eg_V3.Models.CiudadRef" } } } } }, "404": { "description": "La ciudad, no existe." } } } }, "/v3/colores": { "get": { "tags": [ "Colores" ], "summary": "Lista de Colores.", "parameters": [ { "name": "q", "in": "query", "description": "Parte del nombre a buscar", "schema": { "type": "string" } }, { "name": "nombre", "in": "query", "description": "Nombre completo del color", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Lista completa de colores.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Colores" }, "examples": { "eg_V3.Models.Colores": { "$ref": "#/components/examples/eg_V3.Models.Colores" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Colores" }, "examples": { "eg_V3.Models.Colores": { "$ref": "#/components/examples/eg_V3.Models.Colores" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Colores" }, "examples": { "eg_V3.Models.Colores": { "$ref": "#/components/examples/eg_V3.Models.Colores" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.ColoresRef" }, "examples": { "eg_V3.Models.ColoresRef": { "$ref": "#/components/examples/eg_V3.Models.ColoresRef" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/colores/{id}": { "get": { "tags": [ "Colores" ], "summary": "Color por Id.", "parameters": [ { "name": "id", "in": "path", "description": "Id del color", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Color" }, "examples": { "eg_V3.Models.Color": { "$ref": "#/components/examples/eg_V3.Models.Color" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Color" }, "examples": { "eg_V3.Models.Color": { "$ref": "#/components/examples/eg_V3.Models.Color" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Color" }, "examples": { "eg_V3.Models.Color": { "$ref": "#/components/examples/eg_V3.Models.Color" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.ColorRef" }, "examples": { "eg_V3.Models.ColorRef": { "$ref": "#/components/examples/eg_V3.Models.ColorRef" } } } } }, "404": { "description": "El color, no existe." } } } }, "/v3/consultas/{adminmail}": { "get": { "tags": [ "Consultas" ], "summary": "Consultas recibidas en un determinado periodo.\r\nLa lista, paginada, representa las consultas recibidas a las publicaciones que fueron publicadas por tu app.\r\nEn el caso tu app esté habilitada por la agencia, podrás acceder a otros tipo de consultas que serán incluidas siempre en la misma lista.", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia (opcional si especifica el operador).", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" }, "example": "admin@agencia.com" }, { "name": "operador", "in": "query", "description": "Email del colaborador de la agencia (solo las consultas visibles al colaborador).", "schema": { "type": "string", "format": "email" }, "example": "felipe@agencia.com" }, { "name": "externalid", "in": "query", "description": "ExternalId de la publicación", "schema": { "type": "string" } }, { "name": "desde", "in": "query", "description": "Día inicial de recepción de la consulta (mín= today - 90dias).", "schema": { "type": "string", "format": "date" }, "example": "2021-07-01" }, { "name": "hasta", "in": "query", "description": "Día final de recepción de la consulta.", "schema": { "type": "string", "format": "date" }, "example": "2021-09-30" }, { "name": "pagina", "in": "query", "description": "Página del listado (máx 99)", "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Consultas" }, "examples": { "eg_V3.Models.Consultas": { "$ref": "#/components/examples/eg_V3.Models.Consultas" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Consultas" }, "examples": { "eg_V3.Models.Consultas": { "$ref": "#/components/examples/eg_V3.Models.Consultas" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Consultas" }, "examples": { "eg_V3.Models.Consultas": { "$ref": "#/components/examples/eg_V3.Models.Consultas" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.ConsultasRef" }, "examples": { "eg_V3.Models.ConsultasRef": { "$ref": "#/components/examples/eg_V3.Models.ConsultasRef" } } } } }, "404": { "description": "La agencia, para tu app, no existe." }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/consultas/{adminmail}/{sid}": { "get": { "tags": [ "Consultas" ], "summary": "Consulta.", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } }, { "name": "sid", "in": "path", "description": "Id consulta", "required": true, "schema": { "maxLength": 30, "minLength": 20, "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Consulta" }, "examples": { "eg_V3.Models.Consulta": { "$ref": "#/components/examples/eg_V3.Models.Consulta" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Consulta" }, "examples": { "eg_V3.Models.Consulta": { "$ref": "#/components/examples/eg_V3.Models.Consulta" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Consulta" }, "examples": { "eg_V3.Models.Consulta": { "$ref": "#/components/examples/eg_V3.Models.Consulta" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.ConsultaRef" }, "examples": { "eg_V3.Models.ConsultaRef": { "$ref": "#/components/examples/eg_V3.Models.ConsultaRef" } } } } }, "404": { "description": "Para tu app, no existe la agencia o no existe la consulta." }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/consultas/{adminmail}/{sid}/resendwebhook": { "post": { "tags": [ "Consultas" ], "summary": "Vuelve a enviar el WebHook de una consulta específica relativamente reciente.", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } }, { "name": "sid", "in": "path", "description": "Id consulta", "required": true, "schema": { "maxLength": 30, "minLength": 20, "type": "string" } } ], "responses": { "202": { "description": "Resend aceptado (el content tendrá el payload del webhook que se envió).", "headers": { "Location": { "description": "URI de la callback del webhook.", "schema": { "type": "string", "format": "uri" } } } }, "403": { "description": "Para tu app, no existe la agencia.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } } } }, "404": { "description": "Para tu app, no existe la consulta." }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3": { "get": { "tags": [ "Home" ], "summary": "Puntos de entrada a la API.\r\nLos entry-points no son estrictamente relacionados entre si; en varios casos desde un punto de entrada accedes a otros puntos\r\n(como navegando desde la home de un sitio a sus páginas internas).", "responses": { "304": { "description": "Not Modified" }, "200": { "description": "", "headers": { "ETag": { "description": "", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.EntryPoints" }, "examples": { "eg_V3.Models.EntryPoints": { "$ref": "#/components/examples/eg_V3.Models.EntryPoints" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.EntryPoints" }, "examples": { "eg_V3.Models.EntryPoints": { "$ref": "#/components/examples/eg_V3.Models.EntryPoints" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.EntryPoints" }, "examples": { "eg_V3.Models.EntryPoints": { "$ref": "#/components/examples/eg_V3.Models.EntryPoints" } } } } } } } }, "/v3/marcas": { "get": { "tags": [ "Marcas" ], "summary": "Lista de Marcas.", "parameters": [ { "name": "q", "in": "query", "description": "Parte nombre de la marca o Codename.", "schema": { "type": "string" } }, { "name": "soloMercadoNuevos", "in": "query", "description": "Filtra solo marcas disponibles actualmente en el mercados de nuevos (default=false).", "schema": { "type": "boolean", "default": false } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Marcas" }, "examples": { "eg_V3.Models.Marcas": { "$ref": "#/components/examples/eg_V3.Models.Marcas" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Marcas" }, "examples": { "eg_V3.Models.Marcas": { "$ref": "#/components/examples/eg_V3.Models.Marcas" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Marcas" }, "examples": { "eg_V3.Models.Marcas": { "$ref": "#/components/examples/eg_V3.Models.Marcas" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.MarcasRef" }, "examples": { "eg_V3.Models.MarcasRef": { "$ref": "#/components/examples/eg_V3.Models.MarcasRef" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/marcas/bestmatch": { "get": { "tags": [ "Marcas" ], "summary": "Búsqueda de marca que mejor encaja según los parámetros suministrados.", "parameters": [ { "name": "make", "in": "query", "description": "Valor de búsqueda para marca; suportado id, api-url, api-url-path, nombre, codename.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Marca" }, "examples": { "eg_V3.Models.Marca": { "$ref": "#/components/examples/eg_V3.Models.Marca" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Marca" }, "examples": { "eg_V3.Models.Marca": { "$ref": "#/components/examples/eg_V3.Models.Marca" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Marca" }, "examples": { "eg_V3.Models.Marca": { "$ref": "#/components/examples/eg_V3.Models.Marca" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.MarcaRef" }, "examples": { "eg_V3.Models.MarcaRef": { "$ref": "#/components/examples/eg_V3.Models.MarcaRef" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/marcas/{id}": { "get": { "tags": [ "Marcas" ], "summary": "Marca por Id", "parameters": [ { "name": "id", "in": "path", "description": "Id de la marca", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Marca" }, "examples": { "eg_V3.Models.Marca": { "$ref": "#/components/examples/eg_V3.Models.Marca" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Marca" }, "examples": { "eg_V3.Models.Marca": { "$ref": "#/components/examples/eg_V3.Models.Marca" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Marca" }, "examples": { "eg_V3.Models.Marca": { "$ref": "#/components/examples/eg_V3.Models.Marca" } } } } }, "404": { "description": "La marca, no existe." } } } }, "/v3/modelos": { "get": { "tags": [ "Modelos" ], "summary": "Lista de Modelos de una marca.", "parameters": [ { "name": "marca", "in": "query", "description": "Marca para la cual listar modelos (requerido)", "schema": { "type": "integer", "format": "int32", "default": 0 } }, { "name": "q", "in": "query", "description": "Parte del nombre del Modelo", "schema": { "type": "string" } }, { "name": "soloMercadoNuevos", "in": "query", "description": "Filtra solo modelos disponibles actualmente en el mercados de nuevos (default=false).", "schema": { "type": "boolean", "default": false } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Modelos" }, "examples": { "eg_V3.Models.Modelos": { "$ref": "#/components/examples/eg_V3.Models.Modelos" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Modelos" }, "examples": { "eg_V3.Models.Modelos": { "$ref": "#/components/examples/eg_V3.Models.Modelos" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Modelos" }, "examples": { "eg_V3.Models.Modelos": { "$ref": "#/components/examples/eg_V3.Models.Modelos" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.ModelosRef" }, "examples": { "eg_V3.Models.ModelosRef": { "$ref": "#/components/examples/eg_V3.Models.ModelosRef" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/modelos/bestmatch": { "get": { "tags": [ "Modelos" ], "summary": "Búsqueda de modelo que mejor encaja según los parámetros suministrados.", "parameters": [ { "name": "make", "in": "query", "description": "Valor de búsqueda para marca; soportado id, api-url, api-url-path, nombre, codename.", "required": true, "schema": { "type": "string" } }, { "name": "model", "in": "query", "description": "Valor de búsqueda para modelo; soportado id, api-url, api-url-path, nombre completo, parte del nombre, codename.", "required": true, "schema": { "type": "string" } }, { "name": "bodystyle", "in": "query", "description": "Valor de búsqueda para carrocería; soportado id, api-url, api-url-path, nombre, codename.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Modelo" }, "examples": { "eg_V3.Models.Modelo": { "$ref": "#/components/examples/eg_V3.Models.Modelo" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Modelo" }, "examples": { "eg_V3.Models.Modelo": { "$ref": "#/components/examples/eg_V3.Models.Modelo" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Modelo" }, "examples": { "eg_V3.Models.Modelo": { "$ref": "#/components/examples/eg_V3.Models.Modelo" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.ModeloRef" }, "examples": { "eg_V3.Models.ModeloRef": { "$ref": "#/components/examples/eg_V3.Models.ModeloRef" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/modelos/{id}": { "get": { "tags": [ "Modelos" ], "summary": "Modelo.", "parameters": [ { "name": "id", "in": "path", "description": "Id del Modelo", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Modelo" }, "examples": { "eg_V3.Models.Modelo": { "$ref": "#/components/examples/eg_V3.Models.Modelo" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Modelo" }, "examples": { "eg_V3.Models.Modelo": { "$ref": "#/components/examples/eg_V3.Models.Modelo" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Modelo" }, "examples": { "eg_V3.Models.Modelo": { "$ref": "#/components/examples/eg_V3.Models.Modelo" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.ModeloRef" }, "examples": { "eg_V3.Models.ModeloRef": { "$ref": "#/components/examples/eg_V3.Models.ModeloRef" } } } } }, "404": { "description": "El modelo, no existe." } } } }, "/v3/monedas": { "get": { "tags": [ "Monedas" ], "summary": "Lista de Monedas.", "parameters": [ { "name": "q", "in": "query", "description": "Nombre de la moneda o ISO 4217.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Monedas" }, "examples": { "eg_V3.Models.Monedas": { "$ref": "#/components/examples/eg_V3.Models.Monedas" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Monedas" }, "examples": { "eg_V3.Models.Monedas": { "$ref": "#/components/examples/eg_V3.Models.Monedas" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Monedas" }, "examples": { "eg_V3.Models.Monedas": { "$ref": "#/components/examples/eg_V3.Models.Monedas" } } } } } } } }, "/v3/monedas/bestmatch": { "get": { "tags": [ "Monedas" ], "summary": "Búsqueda de monedas que mejor encaja según los parámetros suministrados.", "parameters": [ { "name": "currency", "in": "query", "description": "Valor de búsqueda para moneda; soportado id, api-url, api-url-path, nombre, iso.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Moneda" }, "examples": { "eg_V3.Models.Moneda": { "$ref": "#/components/examples/eg_V3.Models.Moneda" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Moneda" }, "examples": { "eg_V3.Models.Moneda": { "$ref": "#/components/examples/eg_V3.Models.Moneda" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Moneda" }, "examples": { "eg_V3.Models.Moneda": { "$ref": "#/components/examples/eg_V3.Models.Moneda" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/monedas/{id}": { "get": { "tags": [ "Monedas" ], "summary": "Moneda por Id.", "parameters": [ { "name": "id", "in": "path", "description": "Id de la Moneda", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Moneda" }, "examples": { "eg_V3.Models.Moneda": { "$ref": "#/components/examples/eg_V3.Models.Moneda" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Moneda" }, "examples": { "eg_V3.Models.Moneda": { "$ref": "#/components/examples/eg_V3.Models.Moneda" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Moneda" }, "examples": { "eg_V3.Models.Moneda": { "$ref": "#/components/examples/eg_V3.Models.Moneda" } } } } }, "404": { "description": "La moneda, no existe." } } } }, "/v3/notificaciones/{adminmail}": { "get": { "tags": [ "Notificaciones" ], "summary": "Notificaciones de una Agencia.", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.NotificacionesConfig" }, "examples": { "eg_V3.Models.NotificacionesConfig": { "$ref": "#/components/examples/eg_V3.Models.NotificacionesConfig" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.NotificacionesConfig" }, "examples": { "eg_V3.Models.NotificacionesConfig": { "$ref": "#/components/examples/eg_V3.Models.NotificacionesConfig" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.NotificacionesConfig" }, "examples": { "eg_V3.Models.NotificacionesConfig": { "$ref": "#/components/examples/eg_V3.Models.NotificacionesConfig" } } } } }, "404": { "description": "La agencia, para tu app, no existe." }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } }, "put": { "tags": [ "Notificaciones" ], "summary": "Modifica las notificaciones de una Agencia/Concesionaria", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } } ], "requestBody": { "description": "Configuración de notificaciones.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.NotificacionesConfig" }, "examples": { "eg_V3.Models.NotificacionesConfig": { "$ref": "#/components/examples/eg_V3.Models.NotificacionesConfig" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.NotificacionesConfig" }, "examples": { "eg_V3.Models.NotificacionesConfig": { "$ref": "#/components/examples/eg_V3.Models.NotificacionesConfig" } } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.NotificacionesConfig" }, "examples": { "eg_V3.Models.NotificacionesConfig": { "$ref": "#/components/examples/eg_V3.Models.NotificacionesConfig" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.NotificacionesConfig" }, "examples": { "eg_V3.Models.NotificacionesConfig": { "$ref": "#/components/examples/eg_V3.Models.NotificacionesConfig" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.NotificacionesConfig" }, "examples": { "eg_V3.Models.NotificacionesConfig": { "$ref": "#/components/examples/eg_V3.Models.NotificacionesConfig" } } } } }, "403": { "description": "La agencia, para tu app, no existe.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/operadores": { "get": { "tags": [ "Operadores" ], "summary": "Colaborador de una Agencia.", "parameters": [ { "name": "operador", "in": "query", "description": "Email del colaborador de la Agencia.", "required": true, "schema": { "type": "string", "format": "email" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Operador" }, "examples": { "eg_V3.Models.Operador": { "$ref": "#/components/examples/eg_V3.Models.Operador" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Operador" }, "examples": { "eg_V3.Models.Operador": { "$ref": "#/components/examples/eg_V3.Models.Operador" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Operador" }, "examples": { "eg_V3.Models.Operador": { "$ref": "#/components/examples/eg_V3.Models.Operador" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.OperadorRef" }, "examples": { "eg_V3.Models.OperadorRef": { "$ref": "#/components/examples/eg_V3.Models.OperadorRef" } } } } }, "404": { "description": "El operador, para tu app, no existe." }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/operadores/{adminmail}": { "get": { "tags": [ "Operadores" ], "summary": "Colaboradores de una Agencia.", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } }, { "name": "operador", "in": "query", "description": "Email colaborador de la agencia", "schema": { "type": "string", "format": "email" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Operadores" }, "examples": { "eg_V3.Models.Operadores": { "$ref": "#/components/examples/eg_V3.Models.Operadores" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Operadores" }, "examples": { "eg_V3.Models.Operadores": { "$ref": "#/components/examples/eg_V3.Models.Operadores" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Operadores" }, "examples": { "eg_V3.Models.Operadores": { "$ref": "#/components/examples/eg_V3.Models.Operadores" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.OperadoresRef" }, "examples": { "eg_V3.Models.OperadoresRef": { "$ref": "#/components/examples/eg_V3.Models.OperadoresRef" } } } } }, "404": { "description": "La agencia, para tu app, no existe." }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } }, "put": { "tags": [ "Operadores" ], "summary": "Modificación de la información del administrador.\r\nUn operador debería gestionar sus propios datos personales, incluyendo direcciones de ventas y telefonos,\r\ndirectamente accediendo a su cuenta en Autocosmos mientras que por API solo se debería usar la información personal configurada.\r\nEn el caso de administrador de agencia, solo si creado por API, es posible modificar la información.", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } } ], "requestBody": { "description": "Datos del colaborador para actualizar.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.OperadorEdit" }, "examples": { "eg_V3.Models.OperadorEdit": { "$ref": "#/components/examples/eg_V3.Models.OperadorEdit" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.OperadorEdit" }, "examples": { "eg_V3.Models.OperadorEdit": { "$ref": "#/components/examples/eg_V3.Models.OperadorEdit" } } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Operador" }, "examples": { "eg_V3.Models.Operador": { "$ref": "#/components/examples/eg_V3.Models.Operador" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Operador" }, "examples": { "eg_V3.Models.Operador": { "$ref": "#/components/examples/eg_V3.Models.Operador" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Operador" }, "examples": { "eg_V3.Models.Operador": { "$ref": "#/components/examples/eg_V3.Models.Operador" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.OperadorRef" }, "examples": { "eg_V3.Models.OperadorRef": { "$ref": "#/components/examples/eg_V3.Models.OperadorRef" } } } } }, "404": { "description": "El operador no es colaborador de la agencia." }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } }, "403": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } } } } } } }, "/v3/operadores/{adminmail}/invitar": { "post": { "tags": [ "Operadores" ], "summary": "Invitación colaborador de agencia.\r\nEnvía un e-mail al colaborador para que acepte la invitación. \r\nEn el caso no sea registrado podrá registrarse siguiendo los pasos del e-mail.", "parameters": [ { "name": "adminMail", "in": "path", "description": "E-mail operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } }, { "name": "operador", "in": "query", "description": "E-mail del operador para invitar a colaborar con la agencia.", "required": true, "schema": { "type": "string", "format": "email" } } ], "responses": { "202": { "description": "Accepted", "headers": { "Location": { "description": "URI lista de colaboradores de la agencia.", "schema": { "type": "string", "format": "uri" } } } }, "403": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } }, "409": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/operadores/{adminmail}/desasociar": { "patch": { "tags": [ "Operadores" ], "summary": "Desasocia un colaborador de una agencia.\r\nEl colaborador quedará como usuario de Autocosmos y podrá ser invitado a operar con otra agencia.", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } }, { "name": "operador", "in": "query", "description": "Email del operador a desasociar", "required": true, "schema": { "type": "string", "format": "email" } }, { "name": "operadorDestino", "in": "query", "description": "Email del operador al que serán transferidas las publicaciones, consultas etc.", "required": true, "schema": { "type": "string", "format": "email" } } ], "responses": { "204": { "description": "No Content" }, "403": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/propulsiones": { "get": { "tags": [ "Propulsiones" ], "summary": "Lista de propulsiones.", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Propulsiones" }, "examples": { "eg_V3.Models.Propulsiones": { "$ref": "#/components/examples/eg_V3.Models.Propulsiones" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Propulsiones" }, "examples": { "eg_V3.Models.Propulsiones": { "$ref": "#/components/examples/eg_V3.Models.Propulsiones" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Propulsiones" }, "examples": { "eg_V3.Models.Propulsiones": { "$ref": "#/components/examples/eg_V3.Models.Propulsiones" } } } } } } } }, "/v3/propulsiones/bestmatch": { "get": { "tags": [ "Propulsiones" ], "summary": "Búsqueda de propulsión que mejor encaja según los parámetros suministrados.", "parameters": [ { "name": "fuelType", "in": "query", "description": "Valor de búsqueda para propulsión; soportado id, api-url, api-url-path, nombre, codename.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Propulsion" }, "examples": { "eg_V3.Models.Propulsion": { "$ref": "#/components/examples/eg_V3.Models.Propulsion" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Propulsion" }, "examples": { "eg_V3.Models.Propulsion": { "$ref": "#/components/examples/eg_V3.Models.Propulsion" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Propulsion" }, "examples": { "eg_V3.Models.Propulsion": { "$ref": "#/components/examples/eg_V3.Models.Propulsion" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Propulsion" }, "examples": { "eg_V3.Models.Propulsion": { "$ref": "#/components/examples/eg_V3.Models.Propulsion" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/propulsiones/{id}": { "get": { "tags": [ "Propulsiones" ], "summary": "Propulsión por Id.", "parameters": [ { "name": "id", "in": "path", "description": "Id", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Propulsion" }, "examples": { "eg_V3.Models.Propulsion": { "$ref": "#/components/examples/eg_V3.Models.Propulsion" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Propulsion" }, "examples": { "eg_V3.Models.Propulsion": { "$ref": "#/components/examples/eg_V3.Models.Propulsion" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Propulsion" }, "examples": { "eg_V3.Models.Propulsion": { "$ref": "#/components/examples/eg_V3.Models.Propulsion" } } } } }, "404": { "description": "La propulsión, no existe." } } } }, "/v3/publicaciones/{adminmail}": { "get": { "tags": [ "Publicaciones" ], "summary": "Lista de Publicaciones.", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } }, { "name": "operador", "in": "query", "description": "Email del colaborador de la agencia (solo las publicaciones gestionables del colaborador).", "schema": { "type": "string", "format": "email" } }, { "name": "pagina", "in": "query", "description": "Página del listado (máx 99)", "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicaciones" }, "examples": { "eg_V3.Models.Publicaciones": { "$ref": "#/components/examples/eg_V3.Models.Publicaciones" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicaciones" }, "examples": { "eg_V3.Models.Publicaciones": { "$ref": "#/components/examples/eg_V3.Models.Publicaciones" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicaciones" }, "examples": { "eg_V3.Models.Publicaciones": { "$ref": "#/components/examples/eg_V3.Models.Publicaciones" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.PublicacionesRef" }, "examples": { "eg_V3.Models.PublicacionesRef": { "$ref": "#/components/examples/eg_V3.Models.PublicacionesRef" } } } } }, "404": { "description": "La agencia, para tu app, no existe." }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } }, "403": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } } } } } }, "post": { "tags": [ "Publicaciones" ], "summary": "Crea una publicación de auto.", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } } ], "requestBody": { "description": "La información de la publicación a crear", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.PublicacionCreate" }, "examples": { "eg_V3.Models.PublicacionCreate": { "$ref": "#/components/examples/eg_V3.Models.PublicacionCreate" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.PublicacionCreate" }, "examples": { "eg_V3.Models.PublicacionCreate": { "$ref": "#/components/examples/eg_V3.Models.PublicacionCreate" } } } } }, "responses": { "201": { "description": "Created", "headers": { "Location": { "description": "URI publicación.", "schema": { "type": "string", "format": "uri" } }, "ETag": { "description": "", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicacion" }, "examples": { "eg_V3.Models.Publicacion": { "$ref": "#/components/examples/eg_V3.Models.Publicacion" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicacion" }, "examples": { "eg_V3.Models.Publicacion": { "$ref": "#/components/examples/eg_V3.Models.Publicacion" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicacion" }, "examples": { "eg_V3.Models.Publicacion": { "$ref": "#/components/examples/eg_V3.Models.Publicacion" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.PublicacionRef" }, "examples": { "eg_V3.Models.PublicacionRef": { "$ref": "#/components/examples/eg_V3.Models.PublicacionRef" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } }, "409": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } }, "403": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } } } } } } }, "/v3/publicaciones/{adminmail}/{externalid}": { "get": { "tags": [ "Publicaciones" ], "summary": "Publicacion por ExtenalId.", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } }, { "name": "externalid", "in": "path", "description": "ExternalId de la publicación", "required": true, "schema": { "maxLength": 255, "minLength": 2, "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "ETag": { "description": "", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicacion" }, "examples": { "eg_V3.Models.Publicacion": { "$ref": "#/components/examples/eg_V3.Models.Publicacion" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicacion" }, "examples": { "eg_V3.Models.Publicacion": { "$ref": "#/components/examples/eg_V3.Models.Publicacion" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicacion" }, "examples": { "eg_V3.Models.Publicacion": { "$ref": "#/components/examples/eg_V3.Models.Publicacion" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.PublicacionRef" }, "examples": { "eg_V3.Models.PublicacionRef": { "$ref": "#/components/examples/eg_V3.Models.PublicacionRef" } } } } }, "304": { "description": "La publicación no fué modificada (usaste 'ETag' + 'If-None-Match')." }, "404": { "description": "La agencia, para tu app, no existe o no existe la publicación." }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } }, "put": { "tags": [ "Publicaciones" ], "summary": "Modificación publicación.", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } }, { "name": "externalid", "in": "path", "description": "ExternalId de la publicación", "required": true, "schema": { "maxLength": 255, "minLength": 2, "type": "string" } } ], "requestBody": { "description": "Nuevo estado de la publicación", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.PublicacionEdit" }, "examples": { "eg_V3.Models.PublicacionEdit": { "$ref": "#/components/examples/eg_V3.Models.PublicacionEdit" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.PublicacionEdit" }, "examples": { "eg_V3.Models.PublicacionEdit": { "$ref": "#/components/examples/eg_V3.Models.PublicacionEdit" } } } } }, "responses": { "200": { "description": "OK", "headers": { "ETag": { "description": "", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicacion" }, "examples": { "eg_V3.Models.Publicacion": { "$ref": "#/components/examples/eg_V3.Models.Publicacion" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicacion" }, "examples": { "eg_V3.Models.Publicacion": { "$ref": "#/components/examples/eg_V3.Models.Publicacion" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicacion" }, "examples": { "eg_V3.Models.Publicacion": { "$ref": "#/components/examples/eg_V3.Models.Publicacion" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.PublicacionRef" }, "examples": { "eg_V3.Models.PublicacionRef": { "$ref": "#/components/examples/eg_V3.Models.PublicacionRef" } } } } }, "412": { "description": "Precondition Failed. ETag does not match.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } }, "409": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } }, "403": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } } } } } }, "patch": { "tags": [ "Publicaciones" ], "summary": "Modifica el Precios de una Publicación.", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } }, { "name": "externalid", "in": "path", "description": "ExternalId de la publicación", "required": true, "schema": { "maxLength": 255, "minLength": 2, "type": "string" } } ], "requestBody": { "description": "Informaciones parciales para actualizar (se actualizan solo si not null)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.PublicacionPartialEdit" }, "examples": { "eg_V3.Models.PublicacionPartialEdit": { "$ref": "#/components/examples/eg_V3.Models.PublicacionPartialEdit" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.PublicacionPartialEdit" }, "examples": { "eg_V3.Models.PublicacionPartialEdit": { "$ref": "#/components/examples/eg_V3.Models.PublicacionPartialEdit" } } } } }, "responses": { "200": { "description": "OK", "headers": { "ETag": { "description": "", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicacion" }, "examples": { "eg_V3.Models.Publicacion": { "$ref": "#/components/examples/eg_V3.Models.Publicacion" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicacion" }, "examples": { "eg_V3.Models.Publicacion": { "$ref": "#/components/examples/eg_V3.Models.Publicacion" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicacion" }, "examples": { "eg_V3.Models.Publicacion": { "$ref": "#/components/examples/eg_V3.Models.Publicacion" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.PublicacionRef" }, "examples": { "eg_V3.Models.PublicacionRef": { "$ref": "#/components/examples/eg_V3.Models.PublicacionRef" } } } } }, "412": { "description": "Precondition Failed. ETag does not match.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } }, "403": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } } } }, "409": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/publicaciones/{adminmail}/{externalid}/activar": { "patch": { "tags": [ "Publicaciones" ], "summary": "Activa la publicación si están dada las condiciones para que eso suceda.\r\nHay varios motivos por los cuales no es posible activar una publicación:\r\nla suscripción no tiene espacio suficiente, el operador o la suscripción están suspendidos, etc.", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } }, { "name": "externalid", "in": "path", "description": "ExternalId de la publicación", "required": true, "schema": { "maxLength": 255, "minLength": 2, "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "ETag": { "description": "", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicacion" }, "examples": { "eg_V3.Models.Publicacion": { "$ref": "#/components/examples/eg_V3.Models.Publicacion" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicacion" }, "examples": { "eg_V3.Models.Publicacion": { "$ref": "#/components/examples/eg_V3.Models.Publicacion" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicacion" }, "examples": { "eg_V3.Models.Publicacion": { "$ref": "#/components/examples/eg_V3.Models.Publicacion" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.PublicacionRef" }, "examples": { "eg_V3.Models.PublicacionRef": { "$ref": "#/components/examples/eg_V3.Models.PublicacionRef" } } } } }, "412": { "description": "Precondition Failed. ETag does not match.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } }, "403": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } } } }, "409": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/publicaciones/{adminmail}/{externalid}/suspender": { "patch": { "tags": [ "Publicaciones" ], "summary": "Suspende la publicación si están dada las condiciones para que eso suceda.\r\nSuspender una publicación implica: la publicación no será visible en los listados, la publicación no podrá recibir consultas.\r\nUna publicación suspendida puede volver a se activada.", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } }, { "name": "externalid", "in": "path", "description": "ExternalId de la publicación", "required": true, "schema": { "maxLength": 255, "minLength": 2, "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "ETag": { "description": "", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicacion" }, "examples": { "eg_V3.Models.Publicacion": { "$ref": "#/components/examples/eg_V3.Models.Publicacion" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicacion" }, "examples": { "eg_V3.Models.Publicacion": { "$ref": "#/components/examples/eg_V3.Models.Publicacion" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicacion" }, "examples": { "eg_V3.Models.Publicacion": { "$ref": "#/components/examples/eg_V3.Models.Publicacion" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.PublicacionRef" }, "examples": { "eg_V3.Models.PublicacionRef": { "$ref": "#/components/examples/eg_V3.Models.PublicacionRef" } } } } }, "412": { "description": "Precondition Failed. ETag does not match.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } }, "403": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } } } }, "409": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/publicaciones/{adminmail}/{externalid}/archivar": { "patch": { "tags": [ "Publicaciones" ], "summary": "Archiva la publicación.\r\nUna vez archivada la publicación no podrá ser modificada (incluye no podrá ser reactivada).", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } }, { "name": "externalid", "in": "path", "description": "ExternalId de la publicación", "required": true, "schema": { "maxLength": 255, "minLength": 2, "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "ETag": { "description": "", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicacion" }, "examples": { "eg_V3.Models.Publicacion": { "$ref": "#/components/examples/eg_V3.Models.Publicacion" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicacion" }, "examples": { "eg_V3.Models.Publicacion": { "$ref": "#/components/examples/eg_V3.Models.Publicacion" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Publicacion" }, "examples": { "eg_V3.Models.Publicacion": { "$ref": "#/components/examples/eg_V3.Models.Publicacion" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.PublicacionRef" }, "examples": { "eg_V3.Models.PublicacionRef": { "$ref": "#/components/examples/eg_V3.Models.PublicacionRef" } } } } }, "412": { "description": "Precondition Failed. ETag does not match.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } }, "403": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } } } }, "409": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/regiones": { "get": { "tags": [ "Regiones" ], "summary": "Lista de todas las regiones (provincias o estados según corresponda por cada país).", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Regiones" }, "examples": { "eg_V3.Models.Regiones": { "$ref": "#/components/examples/eg_V3.Models.Regiones" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Regiones" }, "examples": { "eg_V3.Models.Regiones": { "$ref": "#/components/examples/eg_V3.Models.Regiones" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Regiones" }, "examples": { "eg_V3.Models.Regiones": { "$ref": "#/components/examples/eg_V3.Models.Regiones" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.RegionesRef" }, "examples": { "eg_V3.Models.RegionesRef": { "$ref": "#/components/examples/eg_V3.Models.RegionesRef" } } } } } } } }, "/v3/regiones/bestmatch": { "get": { "tags": [ "Regiones" ], "summary": "Búsqueda de regiones que mejor encaja según los parámetros suministrados.", "parameters": [ { "name": "state", "in": "query", "description": "Valor de búsqueda para región; soportado id, api-url, api-url-path, nombre, codename.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Region" }, "examples": { "eg_V3.Models.Region": { "$ref": "#/components/examples/eg_V3.Models.Region" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Region" }, "examples": { "eg_V3.Models.Region": { "$ref": "#/components/examples/eg_V3.Models.Region" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Region" }, "examples": { "eg_V3.Models.Region": { "$ref": "#/components/examples/eg_V3.Models.Region" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.RegionRef" }, "examples": { "eg_V3.Models.RegionRef": { "$ref": "#/components/examples/eg_V3.Models.RegionRef" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/regiones/{id}": { "get": { "tags": [ "Regiones" ], "summary": "Región (provincia o estado según corresponda por cada país) por Id.", "parameters": [ { "name": "id", "in": "path", "description": "Id de la Región", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Region" }, "examples": { "eg_V3.Models.Region": { "$ref": "#/components/examples/eg_V3.Models.Region" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Region" }, "examples": { "eg_V3.Models.Region": { "$ref": "#/components/examples/eg_V3.Models.Region" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Region" }, "examples": { "eg_V3.Models.Region": { "$ref": "#/components/examples/eg_V3.Models.Region" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.RegionRef" }, "examples": { "eg_V3.Models.RegionRef": { "$ref": "#/components/examples/eg_V3.Models.RegionRef" } } } } }, "404": { "description": "La región, no existe." } } } }, "/v3/sucursales/{adminmail}": { "get": { "tags": [ "Sucursales" ], "summary": "Sucursales de una Agencia.", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Sucursales" }, "examples": { "eg_V3.Models.Sucursales": { "$ref": "#/components/examples/eg_V3.Models.Sucursales" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Sucursales" }, "examples": { "eg_V3.Models.Sucursales": { "$ref": "#/components/examples/eg_V3.Models.Sucursales" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Sucursales" }, "examples": { "eg_V3.Models.Sucursales": { "$ref": "#/components/examples/eg_V3.Models.Sucursales" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.SucursalesRef" }, "examples": { "eg_V3.Models.SucursalesRef": { "$ref": "#/components/examples/eg_V3.Models.SucursalesRef" } } } } }, "404": { "description": "La agencia, para tu app, no existe." }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } }, "post": { "tags": [ "Sucursales" ], "summary": "Crea una nueva Sucursal", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } } ], "requestBody": { "description": "La información del Vendedor a crear", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Sucursal" }, "examples": { "eg_V3.Models.Sucursal": { "$ref": "#/components/examples/eg_V3.Models.Sucursal" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Sucursal" }, "examples": { "eg_V3.Models.Sucursal": { "$ref": "#/components/examples/eg_V3.Models.Sucursal" } } } }, "required": true }, "responses": { "201": { "description": "Created", "headers": { "Location": { "description": "URI sucursal.", "schema": { "type": "string", "format": "uri" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Sucursal" }, "examples": { "eg_V3.Models.Sucursal": { "$ref": "#/components/examples/eg_V3.Models.Sucursal" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Sucursal" }, "examples": { "eg_V3.Models.Sucursal": { "$ref": "#/components/examples/eg_V3.Models.Sucursal" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Sucursal" }, "examples": { "eg_V3.Models.Sucursal": { "$ref": "#/components/examples/eg_V3.Models.Sucursal" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.SucursalRef" }, "examples": { "eg_V3.Models.SucursalRef": { "$ref": "#/components/examples/eg_V3.Models.SucursalRef" } } } } }, "403": { "description": "La agencia, para tu app, no existe.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } } } }, "409": { "description": "Existe ya una sucursal con la misma información.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/sucursales/{adminmail}/{id}": { "get": { "tags": [ "Sucursales" ], "summary": "Información de una sucursal de una agencia.", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } }, { "name": "id", "in": "path", "description": "ID de la sucursal", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Sucursal" }, "examples": { "eg_V3.Models.Sucursal": { "$ref": "#/components/examples/eg_V3.Models.Sucursal" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Sucursal" }, "examples": { "eg_V3.Models.Sucursal": { "$ref": "#/components/examples/eg_V3.Models.Sucursal" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Sucursal" }, "examples": { "eg_V3.Models.Sucursal": { "$ref": "#/components/examples/eg_V3.Models.Sucursal" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.SucursalRef" }, "examples": { "eg_V3.Models.SucursalRef": { "$ref": "#/components/examples/eg_V3.Models.SucursalRef" } } } } }, "404": { "description": "La agencia, para tu app, no existe o no existe la sucursal." } } }, "put": { "tags": [ "Sucursales" ], "summary": "Modificación de la información de una sucursal.", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } }, { "name": "id", "in": "path", "description": "ID de la sucursal", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Sucursal" }, "examples": { "eg_V3.Models.Sucursal": { "$ref": "#/components/examples/eg_V3.Models.Sucursal" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Sucursal" }, "examples": { "eg_V3.Models.Sucursal": { "$ref": "#/components/examples/eg_V3.Models.Sucursal" } } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Sucursal" }, "examples": { "eg_V3.Models.Sucursal": { "$ref": "#/components/examples/eg_V3.Models.Sucursal" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Sucursal" }, "examples": { "eg_V3.Models.Sucursal": { "$ref": "#/components/examples/eg_V3.Models.Sucursal" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Sucursal" }, "examples": { "eg_V3.Models.Sucursal": { "$ref": "#/components/examples/eg_V3.Models.Sucursal" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.SucursalRef" }, "examples": { "eg_V3.Models.SucursalRef": { "$ref": "#/components/examples/eg_V3.Models.SucursalRef" } } } } }, "403": { "description": "La agencia, para tu app, no existe.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } } } }, "404": { "description": "La sucursal, de la agencia, no existe." }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } }, "delete": { "tags": [ "Sucursales" ], "summary": "Elimina una sucursal de una Agencia.", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } }, { "name": "id", "in": "path", "description": "ID de la sucursal", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "204": { "description": "Sucursal eliminada." }, "403": { "description": "La agencia, para tu app, no existe.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "examples": { "eg_ProblemDetails": { "$ref": "#/components/examples/eg_ProblemDetails" } } } } }, "404": { "description": "La sucursal, de la agencia, no existe." } } } }, "/v3/tests": { "get": { "tags": [ "Tests" ], "summary": "Test, para tu autenticación, en GET.", "responses": { "200": { "description": "OK" } } }, "post": { "tags": [ "Tests" ], "summary": "Test, para tu autenticación, en POST (envía algún valor así incluyes el test de 'Digest' para el calculo del HMAC).", "requestBody": { "description": "Valor a crear", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.TestInput" } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.TestInput" } } } }, "responses": { "201": { "description": "Valor creado", "headers": { "Location": { "description": "fake-URI de valor generado.", "schema": { "type": "string", "format": "uri" } } } } } } }, "/v3/tests/{id}": { "get": { "tags": [ "Tests" ], "summary": "Test, para tu autenticación, en GET: valor único.", "parameters": [ { "name": "id", "in": "path", "description": "Id del valor", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "Para id=1 e id=2" }, "404": { "description": "Para todos los demás valores de id." } } }, "put": { "tags": [ "Tests" ], "summary": "Test, para tu autenticación, en PUT (envía algún valor así incluyes el test de 'Digest' para el calculo del HMAC).", "parameters": [ { "name": "id", "in": "path", "description": "Id del valor a modificar", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "requestBody": { "description": "Nuevo valor", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.TestInput" } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.TestInput" } } } }, "responses": { "200": { "description": "Un echo de lo que enviaste." } } }, "patch": { "tags": [ "Tests" ], "summary": "Test, para tu autenticación, en PATCH.", "parameters": [ { "name": "id", "in": "path", "description": "Id del valor a modificar", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "requestBody": { "description": "Nuevo valor", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.TestInput" } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.TestInput" } } } }, "responses": { "204": { "description": "No content." } } }, "delete": { "tags": [ "Tests" ], "summary": "Test, para tu autenticación, en DELETE.", "parameters": [ { "name": "id", "in": "path", "description": "Id del valor a eliminar", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "Success." } } } }, "/v3/versiones": { "get": { "tags": [ "Versiones" ], "summary": "Lista de Versiones de un modelo (rel: href, find, search).", "parameters": [ { "name": "modelo", "in": "query", "description": "Id del modelo", "required": true, "schema": { "type": "integer", "format": "int32", "default": 0 }, "example": 1234 }, { "name": "year", "in": "query", "description": "Año fabricación/circulación de las versiones (opcional).\r\nSi no especificado, se listarán solo versiones actualmente disponibles en el mercado de autos nuevos.\r\nSi esta especificado se buscarán todas las versiones, eventualmente filtradas por q, relativamente cercanas a ese año.", "schema": { "type": "integer", "format": "int32" }, "example": 2015 }, { "name": "q", "in": "query", "description": "Parte del nombre de la versión.", "schema": { "type": "string" }, "example": "f1" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Versiones" }, "examples": { "eg_V3.Models.Versiones": { "$ref": "#/components/examples/eg_V3.Models.Versiones" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Versiones" }, "examples": { "eg_V3.Models.Versiones": { "$ref": "#/components/examples/eg_V3.Models.Versiones" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Versiones" }, "examples": { "eg_V3.Models.Versiones": { "$ref": "#/components/examples/eg_V3.Models.Versiones" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.VersionesRef" }, "examples": { "eg_V3.Models.VersionesRef": { "$ref": "#/components/examples/eg_V3.Models.VersionesRef" } } } } } } } }, "/v3/versiones/bestmatch": { "get": { "tags": [ "Versiones" ], "summary": "Búsqueda de versión que mejor encaja según los parámetros suministrados.\r\nEste 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.", "parameters": [ { "name": "make", "in": "query", "description": "Valor de búsqueda para marca; soportado id, api-url, api-url-path, nombre, codename.", "required": true, "schema": { "type": "string" }, "example": "ferrari" }, { "name": "model", "in": "query", "description": "Valor de búsqueda para modelo; soportado id, api-url, api-url-path, nombre completo, parte del nombre, codename.", "required": true, "schema": { "type": "string" }, "example": "360" }, { "name": "bodystyle", "in": "query", "description": "Valor de búsqueda para carrocería; soportado id, api-url, api-url-path, nombre, codename.", "schema": { "type": "string" }, "example": "coupe" }, { "name": "trim", "in": "query", "description": "Valor de búsqueda para versión; soportado id, api-url, api-url-path, nombre completo, parte del nombre, codename.\r\nEs posible buscar una versión sin valorizar el parámetro trim y valorizando las características conocidas.", "schema": { "type": "string" }, "example": "f1" }, { "name": "year", "in": "query", "description": "Año fabricación/circulación de las versión.\r\nSi no especificado, sólo se tomarán en cuenta versiones actualmente disponibles en el mercado de autos nuevos.", "schema": { "type": "integer", "format": "int32" }, "example": 2009 }, { "name": "transmissionType", "in": "query", "description": "Tipo de transmisión; suportado 'A','Automatico','M','Manual'.", "schema": { "type": "string" }, "example": "a" }, { "name": "displacement", "in": "query", "description": "Cilindrada del motor a combustión (solo autos que tengan un motor de combustión).\r\nEs suficiente expresar solo el valor sin unidad de medida y redondeado (Ej: cilindrara-real=2755cc displacement=2.8 o displacement=2.8L).", "schema": { "type": "string" }, "example": "5" }, { "name": "power", "in": "query", "description": "Potencia del motor a combustión o eléctrico.\r\nEs suficiente expresar solo el valor sin unidad de medida (Ej: power=204 o power=204cv).", "schema": { "type": "string" }, "example": "340cv" }, { "name": "fuelType", "in": "query", "description": "Valor de búsqueda para el tipo de propulsión; soportado id, api-url, api-url-path, nombre completo, codename.", "schema": { "type": "string" }, "example": "gasolina" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.VersionMatch" }, "examples": { "eg_V3.Models.VersionMatch": { "$ref": "#/components/examples/eg_V3.Models.VersionMatch" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.VersionMatch" }, "examples": { "eg_V3.Models.VersionMatch": { "$ref": "#/components/examples/eg_V3.Models.VersionMatch" } } } } }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } }, "/v3/versiones/{id}": { "get": { "tags": [ "Versiones" ], "summary": "Versión por Id.", "parameters": [ { "name": "id", "in": "path", "description": "Id de la versión.", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Version" }, "examples": { "eg_V3.Models.Version": { "$ref": "#/components/examples/eg_V3.Models.Version" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.Version" }, "examples": { "eg_V3.Models.Version": { "$ref": "#/components/examples/eg_V3.Models.Version" } } }, "application/vnd.autocosmos.entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.Version" }, "examples": { "eg_V3.Models.Version": { "$ref": "#/components/examples/eg_V3.Models.Version" } } }, "application/vnd.autocosmos.ref+json": { "schema": { "$ref": "#/components/schemas/V3.Models.VersionRef" }, "examples": { "eg_V3.Models.VersionRef": { "$ref": "#/components/examples/eg_V3.Models.VersionRef" } } }, "application/vnd.autocosmos.ex-entry+json": { "schema": { "$ref": "#/components/schemas/V3.Models.VersionEx" }, "examples": { "eg_V3.Models.VersionEx": { "$ref": "#/components/examples/eg_V3.Models.VersionEx" } } } } }, "404": { "description": "La versión, no existe." } } } }, "/v3/visitas/{adminmail}": { "get": { "tags": [ "Visitas" ], "summary": "Visitas diarias a publicaciones de una agencia.\r\nÚltimos 3 meses.\r\nPara agencias con ~2000 publicaciones, o menos, este método permite analizar visitas de todas las publicaciones en un mes en un tiempo razonable.\r\nEvita polling, si quieres seguir teniendo acceso a esta funcionalidad.", "parameters": [ { "name": "adminMail", "in": "path", "description": "Email operador administrador de la agencia", "required": true, "schema": { "maxLength": 50, "type": "string", "format": "email" } }, { "name": "year", "in": "query", "description": "Año del mes", "schema": { "type": "integer", "format": "int32" } }, { "name": "month", "in": "query", "description": "Mes seleccionado", "schema": { "type": "integer", "format": "int32" } }, { "name": "day", "in": "query", "description": "Día (no necesario en caso de analizar mes completo). En el caso de agencias con más de 2000 publicaciones es posible obtener un resultado completo solo filtrando un día.", "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V3.Models.VisitasDiarias" }, "examples": { "eg_V3.Models.VisitasDiarias": { "$ref": "#/components/examples/eg_V3.Models.VisitasDiarias" } } }, "text/json": { "schema": { "$ref": "#/components/schemas/V3.Models.VisitasDiarias" }, "examples": { "eg_V3.Models.VisitasDiarias": { "$ref": "#/components/examples/eg_V3.Models.VisitasDiarias" } } } } }, "404": { "description": "La agencia, para tu app, no existe." }, "400": { "description": "", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblemDetails" }, "examples": { "eg_ValidationProblemDetails": { "$ref": "#/components/examples/eg_ValidationProblemDetails" } } } } } } } } }, "components": { "schemas": { "ProblemDetails": { "type": "object", "properties": { "Type": { "type": "string", "nullable": true }, "Title": { "type": "string", "nullable": true }, "Status": { "type": "integer", "format": "int32", "nullable": true }, "Detail": { "type": "string", "nullable": true }, "Instance": { "type": "string", "nullable": true } }, "additionalProperties": { } }, "V3.Models.Agencia": { "type": "object", "properties": { "AdminMail": { "type": "string", "description": "Email del operador administrador de la subscription en Autocosmos.", "nullable": true }, "NombreComercial": { "type": "string", "description": "Nombre comercial (visible al usuario final).", "nullable": true }, "Productos": { "$ref": "#/components/schemas/V3.Models.Entry" }, "Operadores": { "$ref": "#/components/schemas/V3.Models.Entry" }, "Sucursales": { "$ref": "#/components/schemas/V3.Models.Entry" }, "Notificaciones": { "$ref": "#/components/schemas/V3.Models.Entry" }, "Publicaciones": { "$ref": "#/components/schemas/V3.Models.Entry" }, "Consultas": { "$ref": "#/components/schemas/V3.Models.Entry" }, "Visitas": { "$ref": "#/components/schemas/V3.Models.Entry" }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la entidad.\r\nCada propiedad representa la relación/acción con la entidad.", "nullable": true } }, "additionalProperties": false, "description": "Agencia registrada." }, "V3.Models.AgenciaCreate": { "required": [ "AdminApellido", "AdminMail", "AdminNombre", "Ciudad", "NombreComercial", "Region", "Telefono" ], "type": "object", "properties": { "AdminMail": { "maxLength": 50, "minLength": 8, "type": "string", "description": "Email del operador administrador de la subscription en Autocosmos.", "format": "email" }, "NombreComercial": { "maxLength": 100, "minLength": 3, "type": "string", "description": "Nombre comercial (visible al usuario final)." }, "Region": { "maxLength": 200, "minLength": 0, "type": "string", "description": "Provincia/Estado/Región de la sucursal principal locación de venta/servicio. Valores soportados id, api-url, api-url-path, nombre, iso." }, "Ciudad": { "maxLength": 200, "minLength": 0, "type": "string", "description": "Ciudad de la sucursal principal locación de venta/servicio. Valores soportados id, api-url, api-url-path, nombre completo, parte del nombre." }, "Direccion": { "maxLength": 200, "minLength": 0, "type": "string", "description": "Dirección (calle + altura) de la sucursal principal locación de venta/servicio.", "nullable": true }, "Telefono": { "maxLength": 20, "minLength": 8, "type": "string", "description": "Teléfono sucursal principal. Si se usa el formato '+{country-code}{zone-code}{number}' se intepreta como de tipo Whatsapp.", "format": "tel" }, "AdminNombre": { "maxLength": 50, "minLength": 0, "type": "string", "description": "Nombre del operador administrador de la suscription (friendly name para comunicación con posibles clientes)." }, "AdminApellido": { "maxLength": 50, "minLength": 0, "type": "string", "description": "Apellido del operador administrador de la suscription." } }, "additionalProperties": false, "description": "Registración de una nueva agencia.\r\nEs posible crear una agencia sólo si el email del administrador de la cuenta es desconocido en Autocosmos.\r\nEn caso contrario el propietario de la cuenta existente deberá autorizar la app." }, "V3.Models.AgenciaEdit": { "required": [ "NombreComercial" ], "type": "object", "properties": { "NombreComercial": { "maxLength": 100, "minLength": 3, "type": "string", "description": "Nombre comercial (visible al usuario final)." } }, "additionalProperties": false }, "V3.Models.AgenciaProductos": { "type": "object", "properties": { "Baja": { "$ref": "#/components/schemas/V3.Models.AgenciaProductos_Cantidad" }, "Media": { "$ref": "#/components/schemas/V3.Models.AgenciaProductos_Cantidad" }, "Alta": { "$ref": "#/components/schemas/V3.Models.AgenciaProductos_Cantidad" }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la entidad.\r\nCada propiedad representa la relación/acción con la entidad.", "nullable": true } }, "additionalProperties": false, "description": "Paquete de publicaciones." }, "V3.Models.AgenciaProductos_Cantidad": { "type": "object", "properties": { "Pack": { "type": "integer", "description": "Pack de publicaciones activas contratado.", "format": "int32" }, "Activas": { "type": "integer", "description": "Publicaciones activas.", "format": "int32" }, "Disponibles": { "type": "integer", "description": "Publicaciones activables.", "format": "int32", "readOnly": true } }, "additionalProperties": false, "description": "Estado de uso de un pack de publicaciones" }, "V3.Models.AgenciaRef": { "type": "object", "properties": { "AdminMail": { "type": "string", "nullable": true }, "href": { "type": "string", "description": "URI de la entidad.", "nullable": true, "example": "/v3/entities/xyz" }, "title": { "type": "string", "description": "Titulo de la entidad compuesto por las propiedades principales.", "nullable": true } }, "additionalProperties": false }, "V3.Models.Agencias": { "type": "object", "properties": { "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.Agencia" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.AgenciasRef": { "type": "object", "properties": { "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.AgenciaRef" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.AppWebhook": { "required": [ "Callback" ], "type": "object", "properties": { "Callback": { "maxLength": 1024, "minLength": 0, "type": "string", "description": "URL envío hook", "format": "uri", "example": "https://callbacks.myapp.com/leads/listener/autocosmos" }, "Secret": { "maxLength": 256, "minLength": 16, "type": "string", "description": "Si se especifica el Secret recibirás el header 'Notification-Signature' con el HMAC256 calculado con los valores \r\n(UTF-8 encoded) de los headers Notification-Hook-ID, Notification-Timestamp y Notification-Topic (si disponible).", "nullable": true, "example": "96d0300081d644d3bdceae8fbfc77955" }, "Description": { "maxLength": 256, "minLength": 0, "type": "string", "description": "Texto libre para describir el webhook", "nullable": true }, "Activo": { "type": "boolean", "description": "Activo/Suspendido" }, "HeaderCustom01": { "$ref": "#/components/schemas/V3.Models.CustomHeader" }, "HeaderCustom02": { "$ref": "#/components/schemas/V3.Models.CustomHeader" }, "HeaderCustom03": { "$ref": "#/components/schemas/V3.Models.CustomHeader" }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la entidad.\r\nCada propiedad representa la relación/acción con la entidad.", "nullable": true } }, "additionalProperties": false, "description": "Configuración para las notificaciones de los invitaciones aceptadas a agencias.\t\r\nEstas notificaciones son sólo accesibles desde la API, toda la gestión debe realizar a través de la misma." }, "V3.Models.AppWebhookUpsert": { "required": [ "Callback" ], "type": "object", "properties": { "Callback": { "maxLength": 1024, "minLength": 0, "type": "string", "description": "URL envío hook", "format": "uri", "example": "https://callbacks.myapp.com/autocosmos/event" }, "Secret": { "maxLength": 256, "minLength": 16, "type": "string", "description": "Si se especifica el Secret recibirás el header 'Notification-Signature' con el HMAC256 calculado con los valores \r\n(UTF-8 encoded) de los headers Notification-Hook-ID, Notification-Timestamp y Notification-Topic (si disponible).", "nullable": true, "example": "96d0300081d644d3bdceae8fbfc77955" }, "Description": { "maxLength": 256, "minLength": 0, "type": "string", "description": "Texto libre para describir el webhook", "nullable": true }, "Activo": { "type": "boolean", "description": "Activo/Suspendido" }, "HeaderCustom01": { "$ref": "#/components/schemas/V3.Models.CustomHeader" }, "HeaderCustom02": { "$ref": "#/components/schemas/V3.Models.CustomHeader" }, "HeaderCustom03": { "$ref": "#/components/schemas/V3.Models.CustomHeader" } }, "additionalProperties": false }, "V3.Models.AppWebhooks": { "type": "object", "properties": { "TopicsDisponibles": { "type": "array", "items": { "type": "string" }, "nullable": true }, "TopicsConfigurados": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.AppWebhooks_AppWebhookItem" }, "nullable": true }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la entidad.\r\nCada propiedad representa la relación/acción con la entidad.", "nullable": true } }, "additionalProperties": false, "description": "Lista de webhooks configurados por tu app." }, "V3.Models.AppWebhooks_AppWebhookItem": { "type": "object", "properties": { "Topic": { "type": "string", "nullable": true }, "Config": { "$ref": "#/components/schemas/V3.Models.AppWebhook" } }, "additionalProperties": false }, "V3.Models.Carroceria": { "type": "object", "properties": { "Nombre": { "type": "string", "description": "Nombre de la carrocería (puede ser distinto en cada País).", "nullable": true }, "CodeName": { "type": "string", "description": "Canonical-name, compatibile con su uso en URLs y referencias.", "nullable": true }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la entidad.\r\nCada propiedad representa la relación/acción con la entidad.", "nullable": true } }, "additionalProperties": false }, "V3.Models.Carrocerias": { "type": "object", "properties": { "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.Carroceria" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.Ciudad": { "type": "object", "properties": { "Nombre": { "type": "string", "description": "Nombre de la ciudad.", "nullable": true }, "Region": { "type": "string", "description": "Región a la cual pertenese la ciudad.", "nullable": true }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la entidad.\r\nCada propiedad representa la relación/acción con la entidad.", "nullable": true } }, "additionalProperties": false }, "V3.Models.CiudadRef": { "type": "object", "properties": { "href": { "type": "string", "description": "URI de la entidad.", "nullable": true, "example": "/v3/entities/xyz" }, "title": { "type": "string", "description": "Titulo de la entidad compuesto por las propiedades principales.", "nullable": true } }, "additionalProperties": false }, "V3.Models.Ciudades": { "type": "object", "properties": { "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.Ciudad" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.CiudadesRef": { "type": "object", "properties": { "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.CiudadRef" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.Color": { "type": "object", "properties": { "Nombre": { "type": "string", "description": "Nombre del color.", "nullable": true, "example": "Blueberry" }, "HtmlColor": { "type": "string", "description": "Valor hexadecimal del color.", "nullable": true, "example": "#4269f4" }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la entidad.\r\nCada propiedad representa la relación/acción con la entidad.", "nullable": true } }, "additionalProperties": false, "description": "Color de un auto." }, "V3.Models.ColorRef": { "type": "object", "properties": { "href": { "type": "string", "description": "URI de la entidad.", "nullable": true, "example": "/v3/entities/xyz" }, "title": { "type": "string", "description": "Titulo de la entidad compuesto por las propiedades principales.", "nullable": true } }, "additionalProperties": false }, "V3.Models.Colores": { "type": "object", "properties": { "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.Color" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.ColoresRef": { "type": "object", "properties": { "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.ColorRef" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.Consulta": { "type": "object", "properties": { "Momento": { "type": "string", "format": "date-time" }, "OrigenLead": { "type": "string", "nullable": true }, "TipoAnuncio": { "type": "string", "nullable": true }, "Auto": { "$ref": "#/components/schemas/V3.Models.Consulta_Vehiculo" }, "Interesado": { "$ref": "#/components/schemas/V3.Models.Consulta_Prospecto" }, "OperadorResponsable": { "type": "string", "nullable": true }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la entidad.\r\nCada propiedad representa la relación/acción con la entidad.", "nullable": true } }, "additionalProperties": false }, "V3.Models.ConsultaRef": { "type": "object", "properties": { "href": { "type": "string", "description": "URI de la entidad.", "nullable": true, "example": "/v3/entities/xyz" }, "title": { "type": "string", "description": "Titulo de la entidad compuesto por las propiedades principales.", "nullable": true } }, "additionalProperties": false }, "V3.Models.Consulta_Prospecto": { "type": "object", "properties": { "Interes": { "type": "string", "nullable": true }, "Nombre": { "type": "string", "nullable": true }, "Apellido": { "type": "string", "nullable": true }, "Email": { "type": "string", "nullable": true }, "Telefono": { "type": "string", "nullable": true }, "DocIdentidad": { "type": "string", "nullable": true }, "Provincia": { "type": "string", "nullable": true }, "Ciudad": { "type": "string", "nullable": true }, "Comentario": { "type": "string", "nullable": true }, "InfoOperacion": { "$ref": "#/components/schemas/V3.Models.Consulta_TransaccionInfo" } }, "additionalProperties": false }, "V3.Models.Consulta_TransaccionInfo": { "type": "object", "properties": { "EntregaVehiculo": { "$ref": "#/components/schemas/V3.Models.Consulta_TransaccionInfo_Vehiculo" }, "FinanciacionDeseada": { "$ref": "#/components/schemas/V3.Models.Consulta_TransaccionInfo_Financiacion" }, "QuiereCotizacionSeguro": { "type": "boolean", "nullable": true } }, "additionalProperties": false }, "V3.Models.Consulta_TransaccionInfo_Financiacion": { "type": "object", "properties": { "Adelanto": { "$ref": "#/components/schemas/V3.Models.Valor" }, "Cuota": { "$ref": "#/components/schemas/V3.Models.Valor" } }, "additionalProperties": false }, "V3.Models.Consulta_TransaccionInfo_Vehiculo": { "type": "object", "properties": { "Marca": { "type": "string", "description": "Marca del vehículo que quiere entregar como parte del pago.", "nullable": true }, "Modelo": { "type": "string", "description": "Modelo del vehículo que quiere entregar como parte del pago.", "nullable": true }, "VersionYear": { "type": "integer", "description": "Año de la versión o año de matriculación del auto.", "format": "int32", "nullable": true } }, "additionalProperties": false }, "V3.Models.Consulta_Vehiculo": { "type": "object", "properties": { "ExternalId": { "type": "string", "nullable": true }, "RefStock": { "type": "string", "nullable": true }, "Marca": { "type": "string", "nullable": true }, "Modelo": { "type": "string", "nullable": true }, "Version": { "type": "string", "nullable": true }, "VersionYear": { "type": "integer", "format": "int32", "nullable": true }, "Kilometraje": { "type": "integer", "format": "int32", "nullable": true }, "Color": { "type": "string", "nullable": true }, "BodyType": { "type": "string", "nullable": true }, "Estado": { "type": "string", "nullable": true }, "Precio": { "$ref": "#/components/schemas/V3.Models.Valor" }, "Anticipo": { "$ref": "#/components/schemas/V3.Models.Valor" }, "Cuota": { "$ref": "#/components/schemas/V3.Models.Valor" } }, "additionalProperties": false }, "V3.Models.Consultas": { "type": "object", "properties": { "Desde": { "type": "string", "format": "date-time" }, "Hasta": { "type": "string", "format": "date-time" }, "Pagina": { "type": "integer", "format": "int32" }, "Total": { "type": "integer", "format": "int32" }, "PerPagina": { "type": "integer", "format": "int32" }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.Consulta" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.ConsultasRef": { "type": "object", "properties": { "Desde": { "type": "string", "format": "date-time" }, "Hasta": { "type": "string", "format": "date-time" }, "Pagina": { "type": "integer", "format": "int32" }, "Total": { "type": "integer", "format": "int32" }, "PerPagina": { "type": "integer", "format": "int32" }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.ConsultaRef" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.CustomHeader": { "required": [ "Name" ], "type": "object", "properties": { "Name": { "maxLength": 128, "minLength": 0, "type": "string", "description": "Header name (key)", "example": "X-MYAPP-DEALERCODE" }, "Value": { "maxLength": 1024, "minLength": 0, "type": "string", "description": "Header value", "nullable": true, "example": "I25_97" } }, "additionalProperties": false, "description": "Header custom que será parte de los headers que recibas en el POST." }, "V3.Models.Entry": { "type": "object", "properties": { "_links": { "type": "object", "description": "URIs de las acciones disponibles en la entidad.\r\nCada propiedad representa la relación/acción con la entidad.", "nullable": true } }, "additionalProperties": false }, "V3.Models.EntryPoints": { "type": "object", "properties": { "Agencias": { "$ref": "#/components/schemas/V3.Models.Entry" }, "Regiones": { "$ref": "#/components/schemas/V3.Models.Entry" }, "Ciudades": { "$ref": "#/components/schemas/V3.Models.Entry" }, "Monedas": { "$ref": "#/components/schemas/V3.Models.Entry" }, "Propulsiones": { "$ref": "#/components/schemas/V3.Models.Entry" }, "Carrocerias": { "$ref": "#/components/schemas/V3.Models.Entry" }, "Marcas": { "$ref": "#/components/schemas/V3.Models.Entry" }, "Modelos": { "$ref": "#/components/schemas/V3.Models.Entry" }, "Versiones": { "$ref": "#/components/schemas/V3.Models.Entry" }, "AppNotificaciones": { "$ref": "#/components/schemas/V3.Models.Entry" }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la entidad.\r\nCada propiedad representa la relación/acción con la entidad.", "nullable": true } }, "additionalProperties": false, "description": "Puntos de partida de la API desde los cuales se pueden obtener rutas a otras funcionalidades." }, "V3.Models.Marca": { "type": "object", "properties": { "Nombre": { "type": "string", "description": "Nombre comercial de la marca.", "nullable": true }, "Codenames": { "type": "array", "items": { "type": "string" }, "description": "Canonical-name de la marca, compatibile con su uso en URLs y referencias.", "nullable": true }, "Modelos": { "$ref": "#/components/schemas/V3.Models.Entry" }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la entidad.\r\nCada propiedad representa la relación/acción con la entidad.", "nullable": true } }, "additionalProperties": false, "description": "Marca de auto." }, "V3.Models.MarcaRef": { "type": "object", "properties": { "href": { "type": "string", "description": "URI de la entidad.", "nullable": true, "example": "/v3/entities/xyz" }, "title": { "type": "string", "description": "Titulo de la entidad compuesto por las propiedades principales.", "nullable": true } }, "additionalProperties": false }, "V3.Models.Marcas": { "type": "object", "properties": { "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.Marca" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.MarcasRef": { "type": "object", "properties": { "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.MarcaRef" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.Modelo": { "type": "object", "properties": { "Marca": { "type": "string", "description": "Marca a la cual pertenece el modelo.", "nullable": true }, "Nombre": { "type": "string", "description": "Nombre del modelo.", "nullable": true }, "Codename": { "type": "string", "description": "Canonical-name, compatibile con su uso en URLs y referencias.", "nullable": true }, "Carrocerias": { "type": "array", "items": { "type": "string" }, "description": "Carrocerias de las versiones del modelo.", "nullable": true }, "Versiones": { "$ref": "#/components/schemas/V3.Models.Entry" }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la entidad.\r\nCada propiedad representa la relación/acción con la entidad.", "nullable": true } }, "additionalProperties": false, "description": "Modelo de una marca." }, "V3.Models.ModeloRef": { "type": "object", "properties": { "href": { "type": "string", "description": "URI de la entidad.", "nullable": true, "example": "/v3/entities/xyz" }, "title": { "type": "string", "description": "Titulo de la entidad compuesto por las propiedades principales.", "nullable": true } }, "additionalProperties": false }, "V3.Models.Modelos": { "type": "object", "properties": { "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.Modelo" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.ModelosRef": { "type": "object", "properties": { "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.ModeloRef" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.Moneda": { "type": "object", "properties": { "Nombre": { "type": "string", "description": "Nombre generico de la moneda.", "nullable": true }, "Iso": { "type": "string", "description": "Código moneda ISO 4217 (es lo que usará normalmente para referenciar la moneda).", "nullable": true }, "Simbolo": { "type": "string", "description": "Símbolo de la moneda", "nullable": true }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la entidad.\r\nCada propiedad representa la relación/acción con la entidad.", "nullable": true } }, "additionalProperties": false, "description": "Moneda para precio de compra/venta." }, "V3.Models.Monedas": { "type": "object", "properties": { "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.Moneda" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.NotificacionesConfig": { "type": "object", "properties": { "PublicacionConsultadaWebHook": { "$ref": "#/components/schemas/V3.Models.NotificacionesConfig_WebHookConfig" }, "PublicacionConsultadaAdfHook": { "$ref": "#/components/schemas/V3.Models.NotificacionesConfig_AdfHookConfig" }, "PublicacionConsultadaAdfMail": { "$ref": "#/components/schemas/V3.Models.NotificacionesConfig_AdfMailConfig" }, "PublicacionConsultadaHtmlMail": { "$ref": "#/components/schemas/V3.Models.NotificacionesConfig_HtmlMailConfig" }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la entidad.\r\nCada propiedad representa la relación/acción con la entidad.", "nullable": true } }, "additionalProperties": false, "description": "Configuración para las notificaciones de los leads de las consultas de las publicaciones.\r\nCon excepción del V3.Models.PublicacionConsultadaHtmlMail todas las notificaciones configurables son especificas de la app que la gestiona;\r\nCada agencia y colaborador puede tener activas otras notificaciones y en cualquier momento decidir de modificar/eliminar incluso las notificaciones creadas por aplicaciones.\r\nLas notificaciones creadas desde el portal de Autocosmos no son visibles a las apps que acceden por API." }, "V3.Models.NotificacionesConfig_AdfHookConfig": { "required": [ "Callback" ], "type": "object", "properties": { "Callback": { "maxLength": 1024, "minLength": 0, "type": "string", "description": "URL envío hook", "format": "uri", "example": "https://callbacks.myapp.com/leads/listener/adf" }, "Activo": { "type": "boolean", "description": "Activo/Suspendido" }, "HeaderCustom01": { "$ref": "#/components/schemas/V3.Models.NotificacionesConfig_CustomHeader" } }, "additionalProperties": false, "description": "Notificación POST en formato ADF-XML (Auto-lead Data Format)" }, "V3.Models.NotificacionesConfig_AdfMailConfig": { "required": [ "Email" ], "type": "object", "properties": { "Email": { "maxLength": 1024, "minLength": 0, "type": "string", "description": "E-mail al cual enviar la notificación..", "format": "email", "example": "leads.adf@myapp.com" }, "Activo": { "type": "boolean", "description": "Activo/Suspendido" } }, "additionalProperties": false, "description": "Notificación en formato ADF-XML (Auto-lead Data Format) enviada como body de un e-mail (comúnmente usado por varios CRMs)" }, "V3.Models.NotificacionesConfig_CustomHeader": { "type": "object", "properties": { "Name": { "maxLength": 128, "minLength": 0, "type": "string", "description": "Header name (key)", "nullable": true, "example": "X-MYAPP-DEALERCODE" }, "Value": { "maxLength": 1024, "minLength": 0, "type": "string", "description": "Header value", "nullable": true, "example": "I25_97" } }, "additionalProperties": false, "description": "Header custom que será parte de los headers que recibas en el POST." }, "V3.Models.NotificacionesConfig_HtmlMailConfig": { "type": "object", "properties": { "EmailsCCO": { "maxLength": 500, "minLength": 0, "type": "string", "description": "e-mails en copia oculta; e-mails separados por coma (,).", "nullable": true, "example": "supervisor@agencia.com" }, "Activo": { "type": "boolean", "description": "Activo/Suspendido.\r\nEs posible suspender el envío de mails al poseedor de la cuenta si existe otra notificación válida y activa." } }, "additionalProperties": false, "description": "Mail standard en HTML.\r\nAcosejado solo para humanos (no lo usen para leer notificaciones con un algoritmo)." }, "V3.Models.NotificacionesConfig_WebHookConfig": { "required": [ "Callback" ], "type": "object", "properties": { "Callback": { "maxLength": 1024, "minLength": 0, "type": "string", "description": "URL envío hook", "format": "uri", "example": "https://callbacks.myapp.com/leads/listener/autocosmos" }, "Secret": { "maxLength": 256, "minLength": 16, "type": "string", "description": "Si se especifica el Secret recibirás el header 'Notification-Signature' con el HMAC256 calculado con los valores \r\n(UTF-8 encoded) de los headers Notification-Hook-ID, Notification-Timestamp y Notification-Topic (si disponible).", "nullable": true, "example": "96d0300081d644d3bdceae8fbfc77955" }, "Activo": { "type": "boolean", "description": "Activo/Suspendido" }, "HeaderCustom01": { "$ref": "#/components/schemas/V3.Models.NotificacionesConfig_CustomHeader" }, "HeaderCustom02": { "$ref": "#/components/schemas/V3.Models.NotificacionesConfig_CustomHeader" }, "HeaderCustom03": { "$ref": "#/components/schemas/V3.Models.NotificacionesConfig_CustomHeader" } }, "additionalProperties": false, "description": "Autocosmos webhook." }, "V3.Models.Operador": { "type": "object", "properties": { "Nombre": { "type": "string", "description": "Nombre", "nullable": true }, "Apellido": { "type": "string", "description": "Apellido", "nullable": true }, "Email": { "type": "string", "description": "Email del colaborador.", "nullable": true }, "Telefonos": { "type": "array", "items": { "type": "string" }, "description": "Teléfonos", "nullable": true }, "Direcciones": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.Operador_DireccionVenta" }, "description": "Direcciones de venta definidas por el vendedor.", "nullable": true }, "EsAdministradorAgencia": { "type": "boolean" }, "Publicaciones": { "$ref": "#/components/schemas/V3.Models.Entry" }, "Consultas": { "$ref": "#/components/schemas/V3.Models.Entry" }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la entidad.\r\nCada propiedad representa la relación/acción con la entidad.", "nullable": true } }, "additionalProperties": false, "description": "Colaborador de una agencia." }, "V3.Models.OperadorEdit": { "required": [ "Apellido", "Ciudad", "Nombre", "Region" ], "type": "object", "properties": { "Nombre": { "maxLength": 50, "minLength": 0, "type": "string", "description": "Nombre" }, "Apellido": { "maxLength": 50, "minLength": 0, "type": "string", "description": "Apellido" }, "TelefonoLaboral": { "maxLength": 20, "minLength": 8, "type": "string", "description": "Teléfono laboral", "format": "tel", "nullable": true }, "WhatsApp": { "maxLength": 20, "minLength": 8, "type": "string", "description": "Número Whatsapp. Usar el formato '+{country-code}{zone-code}{number}'.", "format": "tel", "nullable": true }, "Region": { "maxLength": 200, "minLength": 0, "type": "string", "description": "Provincia/Estado/Región de la locación de venta/servicio. Valores soportados id, api-url, api-url-path, nombre, iso." }, "Ciudad": { "maxLength": 200, "minLength": 0, "type": "string", "description": "Ciudad de la locación de venta/servicio. Valores soportados id, api-url, api-url-path, nombre completo, parte del nombre." }, "Direccion": { "maxLength": 200, "minLength": 0, "type": "string", "description": "Dirección (calle + altura) de la sucursal principal locación de venta/servicio.", "nullable": true } }, "additionalProperties": false, "description": "Datos del colaborador." }, "V3.Models.OperadorRef": { "type": "object", "properties": { "href": { "type": "string", "description": "URI de la entidad.", "nullable": true, "example": "/v3/entities/xyz" }, "title": { "type": "string", "description": "Titulo de la entidad compuesto por las propiedades principales.", "nullable": true } }, "additionalProperties": false }, "V3.Models.Operador_DireccionVenta": { "type": "object", "properties": { "Region": { "type": "string", "nullable": true }, "Ciudad": { "type": "string", "nullable": true }, "Direccion": { "type": "string", "nullable": true } }, "additionalProperties": false }, "V3.Models.Operadores": { "type": "object", "properties": { "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.Operador" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.OperadoresRef": { "type": "object", "properties": { "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.OperadorRef" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.Propulsion": { "type": "object", "properties": { "Nombre": { "type": "string", "nullable": true }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la entidad.\r\nCada propiedad representa la relación/acción con la entidad.", "nullable": true } }, "additionalProperties": false, "description": "Propulsion de un auto." }, "V3.Models.Propulsiones": { "type": "object", "properties": { "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.Propulsion" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.Publicacion": { "type": "object", "properties": { "ExternalId": { "type": "string", "description": "ID que tu app asignó.\r\nCaseInsesitive, no admite carácteres incompatibles con valores admitidos en un path-segment de una URL (https://www.w3.org/Addressing/URL/5_URI_BNF.html).", "nullable": true }, "RefStock": { "type": "string", "description": "Identificación del auto en tu stock (matrícula, chasis etc.)", "nullable": true }, "Vin": { "type": "string", "description": "VIN (Vehicle Identification Number) del auto.", "nullable": true }, "EstadoActual": { "type": "string", "description": "Estado de la publicación (Activa, Suspendida, Archivada).\r\nUna publicación 'Archivada' terminó su ciclo de vida; no puede ser más modificada (incluye que no puede cambiar de estado).", "nullable": true }, "Exposicion": { "type": "string", "description": "Nivel de exposición (valores admitidos: Alta, Media, Baja)", "nullable": true }, "OperadorResponsable": { "type": "string", "description": "Colaborador responsable de la publicación.", "nullable": true }, "Marca": { "type": "string", "description": "Nombre de la marca en Autocosmos.", "nullable": true }, "Modelo": { "type": "string", "description": "Nombre del modelo en Autocosmos.", "nullable": true }, "Version": { "type": "string", "description": "El nombre de la versión que usaste cuando creaste la publicación o el nombre de la versión en Autocosmos si al publicar aplicaste un valor provisto por el bestmatch.", "nullable": true }, "VersionYear": { "type": "integer", "description": "Año de la versión o año de matriculación del auto.", "format": "int32" }, "Transmision": { "type": "string", "description": "Tipo de trasmisión Transmision ('Automática', 'Manual', 'A', 'M').", "default": "M", "nullable": true }, "Propulsion": { "type": "string", "description": "Combustible (aka 'FuelType')", "nullable": true }, "Kilometraje": { "type": "integer", "description": "Kilometraje del auto.", "format": "int32" }, "Color": { "type": "string", "description": "Color del auto.", "nullable": true }, "Descripcion": { "type": "string", "description": "Descripción de la operación de venta, comentarios sobre el auto etc.", "nullable": true }, "DatosTecnicosCustom": { "type": "array", "items": { "type": "string" }, "description": "Equipamiento custom (para versiones desconocidas en Autocosmos).\r\nSi creado la publicación usaste un nombre de V3.Models.Version, desconocido en Autocosmos, podrás agregar información del equipamiento y ficha técnica.\r\nSi creado la publicación usaste una referencia a una V3.Models.Version conocida en Autocosmos, usaremos nuestra información de equipamiento y ficha tecnica detallada.", "nullable": true }, "Precio": { "$ref": "#/components/schemas/V3.Models.Valor" }, "Adelanto": { "$ref": "#/components/schemas/V3.Models.Valor" }, "Cuota": { "$ref": "#/components/schemas/V3.Models.Valor" }, "Fotos": { "type": "array", "items": { "type": "string" }, "description": "URLs fotos del auto en nuestro storage.", "nullable": true }, "CertificadoDeGarantiaUsado": { "type": "string", "description": "Nombre del certificado de garantía expuesto en la publicación.", "nullable": true }, "Locacion": { "$ref": "#/components/schemas/V3.Models.Publicacion_DireccionVenta" }, "Telefono": { "type": "string", "description": "Teléfono para la venta del auto.", "nullable": true }, "Consultas": { "$ref": "#/components/schemas/V3.Models.Entry" }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la entidad.\r\nCada propiedad representa la relación/acción con la entidad.", "nullable": true } }, "additionalProperties": false, "description": "Auto publicado." }, "V3.Models.PublicacionCreate": { "required": [ "Color", "ExternalId", "Kilometraje", "Marca", "Modelo", "VersionYear" ], "type": "object", "properties": { "ExternalId": { "maxLength": 255, "minLength": 2, "type": "string", "description": "ID que tu app asignó.\r\nCaseInsesitive, admite solo carácteres compatibles con valores admitidos en un path-segment de una URL (https://www.w3.org/Addressing/URL/5_URI_BNF.html) excluyendo algún otro carácter que nos resultan \"poco sano\"." }, "RefStock": { "maxLength": 25, "minLength": 0, "type": "string", "description": "Identificación del auto en tu stock (matricula, chasis etc.)", "nullable": true }, "Vin": { "maxLength": 17, "minLength": 17, "type": "string", "description": "VIN (Vehicle Identification Number) del auto. Validation: iso3779.", "nullable": true }, "Activa": { "type": "boolean", "description": "Estado de la publicación (true = activa, false = suspendida, default= true).", "default": true }, "Exposicion": { "maxLength": 5, "minLength": 0, "type": "string", "description": "Nivel de exposición (valores admitidos: Alta, Media, Baja)\r\nSi se deja en ```null```, o lo que enviste ya no está disponible, usaremos la mejor permitida/disponible.", "nullable": true }, "OperadorResponsable": { "maxLength": 50, "minLength": 0, "type": "string", "description": "Colaborador responsable de la publicación.\r\nSe usará el colaborador administrador de la agencia si el valor es null.", "format": "email", "nullable": true }, "Marca": { "minLength": 1, "type": "string", "description": "Marca (aka 'make')\r\nSoportado id, api-url, api-url-path, nombre completo, codename (ver Versiones rel = bestmatch)" }, "Modelo": { "minLength": 1, "type": "string", "description": "Modelo del auto (aka 'model')\r\nSoportado id, api-url, api-url-path, nombre completo, codename (ver Versiones rel = bestmatch)" }, "Version": { "maxLength": 50, "minLength": 0, "type": "string", "description": "Versión del auto (aka 'trim')\r\nSoportado id, api-url, api-url-path, nombre completo, codename (ver Versiones rel = bestmatch)\r\nPara determinar Marca+Modelo conocidas por Autocosmos, en el caso proveas un texto desconocido a Autocosmos, usaremos el best-match pero solo con la información disponible en la creación de la publicación (ver Versiones 'rel' = bestmatch).\r\nSi no es posible establecer exactamente una versión conocida por Autocosmos, respecteremos el nombre de la versión que proporcionaste.\r\nSi quieres aprovechar nuestra información técnica, y evitar un mapeo de información de tu lado, es aconsejable que uses la información del response del best-match (ver Versiones rel = bestmatch).", "nullable": true }, "VersionYear": { "maximum": 2050, "minimum": 1908, "type": "integer", "description": "Año de la versión o año de matriculación del auto.", "format": "int32" }, "Transmision": { "type": "string", "description": "Tipo de trasmisión Transmision ('Automática', 'Manual', 'A', 'M').", "nullable": true }, "Propulsion": { "type": "string", "description": "Combustible (aka 'FuelType')\r\nSoportado id, api-url, api-url-path, nombre completo, codename (ver Propulsiones 'rel' = bestmatch).", "nullable": true }, "Carroceria": { "type": "string", "description": "Carrocería (aka 'Body-Style')\r\nSoportado id, api-url, api-url-path, nombre completo, codename (ver Carrocerias 'rel' = bestmatch)", "nullable": true }, "Kilometraje": { "maximum": 999000, "minimum": 0, "type": "integer", "description": "Kilometraje del auto.\r\n0 solo para autos nuevos (no matriculados).\r\nPara autos usados o seminuevos usar el kilometraje real del auto.\r\nAlgunos valores sospechosos o no admitidos en los productos contractados por la agencia, pueden provocar el rechazo de la publicación.", "format": "int32" }, "Color": { "minLength": 1, "type": "string", "description": "Color del auto (truncated at 50 characters)." }, "Descripcion": { "maxLength": 2000, "minLength": 0, "type": "string", "description": "Descripción de la operación de venta, comentarios sobre el auto etc.", "nullable": true }, "DatosTecnicosCustom": { "maxItems": 50, "type": "array", "items": { "type": "string" }, "description": "Equipamiento custom (para versiones desconocidas en Autocosmos).\r\nSi creando la publicación usas un nombre de V3.Models.Version, desconocido en Autocosmos, podrás agregar información del equipamiento y ficha tecnica.\r\nSi creando la publicación usas una referencia a una V3.Models.Version conocida en Autocosmos, usaremos nuestra información de equipamiento y ficha tecnica detallada.", "nullable": true }, "Precio": { "$ref": "#/components/schemas/V3.Models.Valor" }, "Adelanto": { "$ref": "#/components/schemas/V3.Models.Valor" }, "Cuota": { "$ref": "#/components/schemas/V3.Models.Valor" }, "Fotos": { "type": "array", "items": { "type": "string" }, "description": "URLs públicamente accesibles, de las imágenes (haremos un download de la fotos desde estas URLs). \r\nLa lista de fotos se debe completar obligatoriamente para publicación de usados.\r\nHaremos un download de la fotos desde estas URLs. Constraints: min-width=640px;min-height=360px.", "nullable": true }, "AplicaCertificadoGarantiaUsado": { "type": "boolean", "description": "Certificado de garantía expuesto en la publicación." }, "Locacion": { "$ref": "#/components/schemas/V3.Models.Publicacion_DireccionVenta" }, "Telefono": { "type": "string", "description": "Teléfono para la venta del auto.\r\nnull = se usa uno de los telefonos actuales del operador responsable de la publicación\r\nNOTA : normalmente se deja en null", "nullable": true } }, "additionalProperties": false, "description": "Creación de una publicación.\r\nPara Marca, Modelo, Version, Propulsion, Transmision, Carroceria, Region, Ciudad, Moneda etc. siempre nos ocuparemos de usar los algoritmos de 'best-match';\r\nes decir que no es estrictamente necesario que tú lo hagas para cada valor.\r\nEl único 'best-match' que tiene sentido que uses antes de crear una publicación es '/versiones/bestmatch' ya que te permite obtener valores usables en la\r\ncreación de la publicación buscando por informaciones técnicas del auto hasta sin tener el nombre de la versión (aka sin 'trim')." }, "V3.Models.PublicacionEdit": { "required": [ "Color", "Kilometraje", "VersionYear" ], "type": "object", "properties": { "RefStock": { "maxLength": 25, "minLength": 0, "type": "string", "description": "Identificación del auto en tu stock (matricula, chasis etc.)", "nullable": true }, "Vin": { "maxLength": 17, "minLength": 17, "type": "string", "description": "VIN (Vehicle Identification Number) del auto. Validation: iso3779.", "nullable": true }, "Activa": { "type": "boolean", "description": "Nuevo estado de la publicación (true = activa, false = suspendida, default= true)." }, "Exposicion": { "maxLength": 5, "minLength": 0, "type": "string", "description": "Nivel de exposición (valores admitidos: Alta, Media, Baja)\r\nSi se deja en ```null```, o lo que enviste ya no está disponible, usaremos la mejor permitida/disponible.", "nullable": true }, "OperadorResponsable": { "maxLength": 50, "minLength": 0, "type": "string", "description": "Colaborador responsable de la publicación.\r\nSi el valor es null o, por algún motivo, no es admitido, quedará el operador responsable ya asignado anteriormente.", "format": "email", "nullable": true }, "VersionYear": { "maximum": 2050, "minimum": 1908, "type": "integer", "description": "Año de la versión o año de matriculación del auto.", "format": "int32" }, "Kilometraje": { "maximum": 999000, "minimum": 0, "type": "integer", "description": "Kilometraje del auto.\r\n0 solo para autos nuevos (no matriculados).\r\nPara autos usados o seminuevos usar el kilometraje real del auto.\r\nAlgunos valores sospechosos o no admitidos en los productos contractados por la agencia, pueden provocar el rechazo de la publicación.", "format": "int32" }, "Color": { "minLength": 1, "type": "string", "description": "Color del auto (truncated at 50 characters)." }, "Descripcion": { "maxLength": 2000, "minLength": 0, "type": "string", "description": "Descripción de la operación de venta, comentarios sobre el auto etc.", "nullable": true }, "DatosTecnicosCustom": { "maxItems": 50, "type": "array", "items": { "type": "string" }, "description": "Equipamiento custom (para versiones desconocidas en Autocosmos).\r\nSi creando la publicación usaste un nombre de V3.Models.Version, desconocido en Autocosmos, podrás agregar información del equipamiento y ficha tecnica.\r\nSi creando la publicación usaste una referencia a una V3.Models.Version conocida en Autocosmos, usaremos nuestra información de equipamiento y ficha tecnica detallada.", "nullable": true }, "Precio": { "$ref": "#/components/schemas/V3.Models.Valor" }, "Adelanto": { "$ref": "#/components/schemas/V3.Models.Valor" }, "Cuota": { "$ref": "#/components/schemas/V3.Models.Valor" }, "Fotos": { "type": "array", "items": { "type": "string" }, "description": "URLs públicamente accesibles, de las imágenes (haremos un download de la fotos desde estas URLs). \r\nLa modificación de las fotos se ignora si la cantidad de fotos es la misma actualmente disponible en la publicación.\r\nLa lista de fotos se debe completar obligatoriamente para publicación de usados.\r\nHaremos un download de la fotos desde estas URLs. Constraints: min-width=640px;min-height=360px.", "nullable": true }, "AplicaCertificadoGarantiaUsado": { "type": "boolean", "description": "Certificado de garantía expuesto en la publicación." }, "Locacion": { "$ref": "#/components/schemas/V3.Models.Publicacion_DireccionVenta" }, "Telefono": { "type": "string", "description": "Teléfono para la venta del auto (debe corresponder completamente a uno de los teléfonos del operador responsable de la publicación).\r\nnull = se usa uno de los teléfonos actuales del operador responsable de la publicación\r\nNOTA : normalmente se deja en null", "nullable": true } }, "additionalProperties": false, "description": "Información modificable de una publicación." }, "V3.Models.PublicacionPartialEdit": { "type": "object", "properties": { "Precio": { "$ref": "#/components/schemas/V3.Models.Valor" }, "Adelanto": { "$ref": "#/components/schemas/V3.Models.Valor" }, "Cuota": { "$ref": "#/components/schemas/V3.Models.Valor" }, "Activa": { "type": "boolean", "description": "Nuevo estado de la publicación.\r\ntrue = activa, false = suspendida, null = deja el estado actual invariado", "nullable": true } }, "additionalProperties": false, "description": "Información parcial modificable de una publicación." }, "V3.Models.PublicacionRef": { "type": "object", "properties": { "etag": { "type": "string", "nullable": true }, "ExternalId": { "type": "string", "description": "ID que tu app asignó.", "nullable": true }, "EstadoActual": { "type": "string", "description": "Estado de la publicación (Activa, Suspendida, Archivada).", "nullable": true }, "href": { "type": "string", "description": "URI de la entidad.", "nullable": true, "example": "/v3/entities/xyz" }, "title": { "type": "string", "description": "Titulo de la entidad compuesto por las propiedades principales.", "nullable": true } }, "additionalProperties": false, "description": "Reference auto publicado." }, "V3.Models.Publicacion_DireccionVenta": { "required": [ "Ciudad", "Region" ], "type": "object", "properties": { "Region": { "maxLength": 200, "minLength": 0, "type": "string", "description": "Provincia/Estado/Región de la sucursal principal locación de venta/servicio. Valores soportados id, api-url, api-url-path, nombre, iso." }, "Ciudad": { "maxLength": 200, "minLength": 0, "type": "string", "description": "Ciudad de la sucursal principal locación de venta/servicio. Valores soportados id, api-url, api-url-path, nombre completo, parte del nombre." }, "Direccion": { "maxLength": 200, "minLength": 0, "type": "string", "description": "Dirección (calle + altura) de la sucursal.", "nullable": true } }, "additionalProperties": false, "description": "Dirección de venta del auto (debe corresponder completamente a una de las direcciones del operador responsable de la publicación)." }, "V3.Models.Publicaciones": { "type": "object", "properties": { "Pagina": { "type": "integer", "format": "int32" }, "Total": { "type": "integer", "format": "int32" }, "PerPagina": { "type": "integer", "format": "int32" }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.Publicacion" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.PublicacionesRef": { "type": "object", "properties": { "Pagina": { "type": "integer", "format": "int32" }, "Total": { "type": "integer", "format": "int32" }, "PerPagina": { "type": "integer", "format": "int32" }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.PublicacionRef" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.Region": { "type": "object", "properties": { "Nombre": { "type": "string", "description": "Nombre del estado/provincia/región etc.", "nullable": true }, "Iso": { "type": "string", "description": "ISO 3166-2 de la región. \r\nSi todo está como debería podrás conocer las Ciudades sin antes hacer un query a las regiones ya que el ISO es un acuerdo internacional.\r\n(es lo que usará normalmente para referenciar la región).", "nullable": true }, "Ciudades": { "$ref": "#/components/schemas/V3.Models.Entry" }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la entidad.\r\nCada propiedad representa la relación/acción con la entidad.", "nullable": true } }, "additionalProperties": false, "description": "División politica del territorio de un país (estado, provicia, región etc.)." }, "V3.Models.RegionRef": { "type": "object", "properties": { "href": { "type": "string", "description": "URI de la entidad.", "nullable": true, "example": "/v3/entities/xyz" }, "title": { "type": "string", "description": "Titulo de la entidad compuesto por las propiedades principales.", "nullable": true } }, "additionalProperties": false }, "V3.Models.Regiones": { "type": "object", "properties": { "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.Region" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.RegionesRef": { "type": "object", "properties": { "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.RegionRef" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.Sucursal": { "required": [ "Ciudad", "Region" ], "type": "object", "properties": { "Descripcion": { "type": "string", "description": "Descripción de la sucursal", "nullable": true, "example": "Sede central" }, "Email": { "maxLength": 50, "minLength": 0, "type": "string", "description": "E-mail publico de la sucursal.", "format": "email", "nullable": true, "example": "sac@agencia.com" }, "Telefono": { "maxLength": 50, "minLength": 0, "type": "string", "description": "Teléfono de atención al público.", "format": "tel", "nullable": true }, "Region": { "maxLength": 200, "minLength": 0, "type": "string", "description": "Provincia/Estado/Región de la sucursal principal locación de venta/servicio. Valores soportados id, api-url, api-url-path, nombre, iso." }, "Ciudad": { "maxLength": 200, "minLength": 0, "type": "string", "description": "Ciudad de la sucursal principal locación de venta/servicio. Valores soportados id, api-url, api-url-path, nombre completo, parte del nombre.\r\n(ver /v3/ciudades/bestmatch)" }, "Direccion": { "maxLength": 200, "minLength": 0, "type": "string", "description": "Dirección (calle + altura) de la sucursal.", "nullable": true, "example": "Av. Siempreviva 742" }, "Comercial": { "type": "boolean", "description": "La sucursal da servicio de compra/venta." }, "TallerMecanico": { "type": "boolean", "description": "La sucursal da servicio de taller." }, "Autopartes": { "type": "boolean", "description": "La sucursal vende autopartes." }, "Laborable": { "$ref": "#/components/schemas/V3.Models.Sucursal_HorarioPublico" }, "PreFestivo": { "$ref": "#/components/schemas/V3.Models.Sucursal_HorarioPublico" }, "Festivo": { "$ref": "#/components/schemas/V3.Models.Sucursal_HorarioPublico" }, "ResponsableLeadsPostVenta": { "maxLength": 50, "minLength": 0, "type": "string", "description": "E-mail responsable leads de post-venta. Debe ser un e-mail de un operador habilitado a operar con la agencia.\r\nSerá ignorado en el caso la agencia no esté habilitada a recibir leads de post-venta.", "format": "email", "nullable": true, "example": "postventa@agencia.com" }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la entidad.\r\nCada propiedad representa la relación/acción con la entidad.", "nullable": true } }, "additionalProperties": false, "description": "Sucursal de una agencia habilitada a venta o servicio." }, "V3.Models.SucursalRef": { "type": "object", "properties": { "href": { "type": "string", "description": "URI de la entidad.", "nullable": true, "example": "/v3/entities/xyz" }, "title": { "type": "string", "description": "Titulo de la entidad compuesto por las propiedades principales.", "nullable": true } }, "additionalProperties": false }, "V3.Models.Sucursal_HorarioPublico": { "type": "object", "properties": { "Desde": { "type": "string", "description": "Hora de apertura.", "format": "time", "nullable": true, "example": "08:00:00" }, "Hasta": { "type": "string", "description": "Hora de cierre", "format": "time", "nullable": true, "example": "19:00:00" } }, "additionalProperties": false }, "V3.Models.Sucursales": { "type": "object", "properties": { "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.Sucursal" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.SucursalesRef": { "type": "object", "properties": { "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.SucursalRef" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.TestInput": { "required": [ "Valor" ], "type": "object", "properties": { "Valor": { "minLength": 3, "type": "string" } }, "additionalProperties": false }, "V3.Models.Valor": { "type": "object", "properties": { "Moneda": { "type": "string", "description": "Código moneda ISO 4217.", "nullable": true, "example": "USD" }, "Importe": { "type": "integer", "description": "Importe", "format": "int32" } }, "additionalProperties": false }, "V3.Models.Version": { "type": "object", "properties": { "VersionYear": { "type": "integer", "description": "Año de la versión del auto (solo para autos actualmente disponibles en el mercado de autos nuevos).", "format": "int32", "nullable": true }, "Propulsion": { "type": "string", "description": "Combustible, eléctrico etc.", "nullable": true, "example": "Gasolina" }, "Transmision": { "type": "string", "description": "Tipo de trasmision.", "nullable": true, "example": "Manual" }, "Potencia": { "type": "string", "description": "Potencia del motor.", "nullable": true, "example": "478 cv" }, "Cilindrada": { "type": "string", "description": "Cilindrada", "nullable": true, "example": "2936 cm³" }, "Marca": { "type": "string", "description": "Marca a la cual pertenece el modelo.", "nullable": true, "example": "Ferrari" }, "Modelo": { "type": "string", "description": "Modelo de la versión.", "nullable": true, "example": "F40" }, "Nombre": { "type": "string", "description": "Nombre de la versión.", "nullable": true, "example": "GTE" }, "Codename": { "type": "string", "description": "Canonical-name, compatibile con su uso en URLs y referencias.", "nullable": true, "example": "gte" }, "Carroceria": { "type": "string", "description": "Carrocería (aka Body-Style)", "nullable": true, "example": "Coupe" }, "Segmento": { "type": "string", "description": "Segmento en la carrocería (aka segment, car classification)", "nullable": true, "example": "C" }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la entidad.\r\nCada propiedad representa la relación/acción con la entidad.", "nullable": true } }, "additionalProperties": false, "description": "Información de la versión." }, "V3.Models.VersionEx": { "type": "object", "properties": { "VersionYear": { "type": "integer", "description": "Año de la versión del auto.", "format": "int32" }, "Origen": { "type": "string", "description": "País de fabricación del auto.", "nullable": true, "example": "Italia" }, "Garantia": { "type": "string", "description": "Garantía ofrecida por el fabricante.", "nullable": true, "example": "2 años o 100000km" }, "Foto": { "type": "string", "description": "Foto principal", "nullable": true, "example": "https://somedomain/somefolder/foto.jpg" }, "Precio": { "$ref": "#/components/schemas/V3.Models.Valor" }, "Colores": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.VersionEx_Color" }, "description": "Esquema de colores provisto por el fabricante.", "nullable": true }, "ActualmenteDisponible": { "type": "boolean", "description": "Actualmente disponible en el mercado de autos nuevos." }, "InfoTecnica": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.VersionEx_InfoTecnicaSpec" }, "description": "Información de la ficha técnica y del equipamiento.", "nullable": true }, "Marca": { "type": "string", "description": "Marca a la cual pertenece el modelo.", "nullable": true, "example": "Ferrari" }, "Modelo": { "type": "string", "description": "Modelo de la versión.", "nullable": true, "example": "F40" }, "Nombre": { "type": "string", "description": "Nombre de la versión.", "nullable": true, "example": "GTE" }, "Codename": { "type": "string", "description": "Canonical-name, compatibile con su uso en URLs y referencias.", "nullable": true, "example": "gte" }, "Carroceria": { "type": "string", "description": "Carrocería (aka Body-Style)", "nullable": true, "example": "Coupe" }, "Segmento": { "type": "string", "description": "Segmento en la carrocería (aka segment, car classification)", "nullable": true, "example": "C" }, "_links": { "type": "object", "description": "URIs de las acciones disponibles en la entidad.\r\nCada propiedad representa la relación/acción con la entidad.", "nullable": true } }, "additionalProperties": false, "description": "Versión (aka trim) de un auto completa de información técnica, garantía, colores disponibles etc." }, "V3.Models.VersionEx_Color": { "type": "object", "properties": { "Desc": { "type": "string", "description": "Nombre del color.", "nullable": true, "example": "Blueberry" }, "HtmlColor": { "type": "string", "description": "Valor hexadecimal del color.", "nullable": true, "example": "#4269f4" } }, "additionalProperties": false }, "V3.Models.VersionEx_InfoTecnicaSpec": { "type": "object", "properties": { "Seccion": { "type": "string", "description": "Sección del auto.", "nullable": true, "example": "Motor" }, "Valor": { "type": "string", "description": "Elemento/Valor.", "nullable": true, "example": "Cilindrada" }, "Datos": { "type": "string", "description": "Dato de la característica con su unidad de medida u opciones del elemento (separadas por coma).", "nullable": true, "example": "1998 cc" } }, "additionalProperties": false }, "V3.Models.VersionMatch": { "type": "object", "properties": { "Make": { "type": "string", "description": "Codename o URL de la marca compatible con el uso en una publicación.", "nullable": true }, "Model": { "type": "string", "description": "Codename o URL del modelo compatible con el uso en una publicación.", "nullable": true }, "Trim": { "type": "string", "description": "Codename o URL de la versión compatible con el uso en una publicación.\r\nEs posible que sea idéntico a lo que usaste en tu búsqueda si Autocosmos no posee toda la información técnica.", "nullable": true }, "FuelType": { "type": "string", "description": "Codename propulsión compatible con el uso en una publicación.", "nullable": true }, "TransmisionType": { "type": "string", "description": "Codename transmisión compatible con el uso en una publicación.", "nullable": true }, "Match": { "$ref": "#/components/schemas/V3.Models.Version" }, "Candidates": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.Version" }, "description": "Versiones candidatas, por la cuales Autocosmos posee la información tecnica, que más se acercan a las caracteristicas usada para el match.", "nullable": true } }, "additionalProperties": false, "description": "Resultado del bestmatch con información utilizable en una publicación." }, "V3.Models.VersionRef": { "type": "object", "properties": { "Marca": { "type": "string", "nullable": true }, "Modelo": { "type": "string", "nullable": true }, "Version": { "type": "string", "nullable": true }, "VersionYear": { "type": "integer", "description": "Año de la versión del auto (solo para autos actualmente disponibles en el mercado de autos nuevos).", "format": "int32", "nullable": true }, "href": { "type": "string", "description": "URI de la entidad.", "nullable": true, "example": "/v3/entities/xyz" }, "title": { "type": "string", "description": "Titulo de la entidad compuesto por las propiedades principales.", "nullable": true } }, "additionalProperties": false }, "V3.Models.Versiones": { "type": "object", "properties": { "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.Version" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.VersionesRef": { "type": "object", "properties": { "_links": { "type": "object", "description": "URIs de las acciones disponibles en la lista de entidades.\r\nCada propiedad representa la relación/acción con la lista de entidades.", "nullable": true }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.VersionRef" }, "description": "Entidades de la collección.", "nullable": true } }, "additionalProperties": false }, "V3.Models.VisitasDiarias": { "type": "object", "properties": { "Year": { "type": "integer", "description": "Año seleccionado", "format": "int32", "example": 2020 }, "Month": { "type": "integer", "description": "Mes seleccionado", "format": "int32", "example": 11 }, "Day": { "type": "integer", "description": "Día seleccionado", "format": "int32", "nullable": true, "example": null }, "_truncated": { "type": "boolean", "description": "Datos truncados por el tamaño de informacción seleccionada." }, "_entries": { "type": "array", "items": { "$ref": "#/components/schemas/V3.Models.VisitasDiariasPublicacion" }, "description": "Visitas diaria de cada publicación visitada.", "nullable": true } }, "additionalProperties": false }, "V3.Models.VisitasDiariasPublicacion": { "type": "object", "properties": { "ExtenalId": { "type": "string", "description": "ID que tu app asignó.", "nullable": true, "example": "ACD12345" }, "Dia": { "type": "string", "description": "Día de las visitas (yyyy-MM-dd) RFC3339.", "format": "date", "nullable": true, "example": "2020-11-25" }, "Visitas": { "type": "integer", "description": "Cantidad de visitas.", "format": "int32" }, "Whatsapp": { "type": "integer", "description": "Cantidad de llamados (tap en abrir whatsapp)", "format": "int32" } }, "additionalProperties": false, "description": "Visitas diaria a una publicación" }, "ValidationProblemDetails": { "type": "object", "properties": { "Errors": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "string" } }, "nullable": true }, "Type": { "type": "string", "nullable": true }, "Title": { "type": "string", "nullable": true }, "Status": { "type": "integer", "format": "int32", "nullable": true }, "Detail": { "type": "string", "nullable": true }, "Instance": { "type": "string", "nullable": true } }, "additionalProperties": { } } }, "examples": { "eg_V3.Models.EntryPoints": { "value": { "Agencias": { "_links": { "rel1": { "href": "/v3/agencias/somevalue" }, "rel2": { "href": "/v3/agencias/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Regiones": { "_links": { "rel1": { "href": "/v3/regiones/somevalue" }, "rel2": { "href": "/v3/regiones/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Ciudades": { "_links": { "rel1": { "href": "/v3/ciudades/somevalue" }, "rel2": { "href": "/v3/ciudades/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Monedas": { "_links": { "rel1": { "href": "/v3/monedas/somevalue" }, "rel2": { "href": "/v3/monedas/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Propulsiones": { "_links": { "rel1": { "href": "/v3/propulsiones/somevalue" }, "rel2": { "href": "/v3/propulsiones/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Carrocerias": { "_links": { "rel1": { "href": "/v3/carrocerias/somevalue" }, "rel2": { "href": "/v3/carrocerias/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Marcas": { "_links": { "rel1": { "href": "/v3/marcas/somevalue" }, "rel2": { "href": "/v3/marcas/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Modelos": { "_links": { "rel1": { "href": "/v3/modelos/somevalue" }, "rel2": { "href": "/v3/modelos/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Versiones": { "_links": { "rel1": { "href": "/v3/versiones/somevalue" }, "rel2": { "href": "/v3/versiones/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "AppNotificaciones": { "_links": { "self": { "href": "/v3/appnotificaciones" } } }, "_links": { "self": { "href": "/v3" } } } }, "eg_ProblemDetails": { "value": { "Type": "https://httpstatuses.com/403", "Title": "Titulo de problema", "Status": 403, "Detail": "Alguna descripción del problema", "Instance": "/v3/somewhere", "Extensions": {} } }, "eg_ValidationProblemDetails": { "value": { "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": {} } }, "eg_V3.Models.Agencia": { "value": { "AdminMail": "franco@superautos.com", "NombreComercial": "Super Autos", "Productos": { "_links": { "rel1": { "href": "/v3/agencias/somevalue" } } }, "Operadores": { "_links": { "rel1": { "href": "/v3/operadores/somevalue" }, "rel2": { "href": "/v3/operadores/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Sucursales": { "_links": { "rel1": { "href": "/v3/sucursales/somevalue" }, "rel2": { "href": "/v3/sucursales/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Notificaciones": { "_links": { "rel1": { "href": "/v3/notificaciones/somevalue" }, "rel2": { "href": "/v3/notificaciones/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Publicaciones": { "_links": { "rel1": { "href": "/v3/publicaciones/somevalue" }, "rel2": { "href": "/v3/publicaciones/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Consultas": { "_links": { "rel1": { "href": "/v3/consultas/somevalue" }, "rel2": { "href": "/v3/consultas/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Visitas": { "_links": { "rel1": { "href": "/v3/visitas/somevalue" }, "rel2": { "href": "/v3/visitas/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "_links": { "rel1": { "href": "/v3/agencias/somevalue" }, "rel2": { "href": "/v3/agencias/somevalue", "method": "PUT" } } } }, "eg_V3.Models.AgenciaRef": { "value": { "AdminMail": "franco@superautos.com", "href": "/v3/agencias/franco@superautos.com", "title": "Super Autos" } }, "eg_V3.Models.Agencias": { "value": { "_links": { "rel1": { "href": "/v3/agencias?someparam=somevalue" }, "rel2": { "href": "/v3/agencias?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "AdminMail": "franco@superautos.com", "NombreComercial": "Super Autos", "Productos": { "_links": { "rel1": { "href": "/v3/agencias/somevalue" } } }, "Operadores": { "_links": { "rel1": { "href": "/v3/operadores/somevalue" }, "rel2": { "href": "/v3/operadores/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Sucursales": { "_links": { "rel1": { "href": "/v3/sucursales/somevalue" }, "rel2": { "href": "/v3/sucursales/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Notificaciones": { "_links": { "rel1": { "href": "/v3/notificaciones/somevalue" }, "rel2": { "href": "/v3/notificaciones/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Publicaciones": { "_links": { "rel1": { "href": "/v3/publicaciones/somevalue" }, "rel2": { "href": "/v3/publicaciones/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Consultas": { "_links": { "rel1": { "href": "/v3/consultas/somevalue" }, "rel2": { "href": "/v3/consultas/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Visitas": { "_links": { "rel1": { "href": "/v3/visitas/somevalue" }, "rel2": { "href": "/v3/visitas/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "_links": { "rel1": { "href": "/v3/agencias/somevalue" }, "rel2": { "href": "/v3/agencias/somevalue", "method": "PUT" } } }, { "AdminMail": "emilio@grandesautos.com", "NombreComercial": "Grandes Autos", "Productos": { "_links": { "rel1": { "href": "/v3/agencias/somevalue" } } }, "Operadores": { "_links": { "rel1": { "href": "/v3/operadores/somevalue" }, "rel2": { "href": "/v3/operadores/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Sucursales": { "_links": { "rel1": { "href": "/v3/sucursales/somevalue" }, "rel2": { "href": "/v3/sucursales/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Notificaciones": { "_links": { "rel1": { "href": "/v3/notificaciones/somevalue" }, "rel2": { "href": "/v3/notificaciones/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Publicaciones": { "_links": { "rel1": { "href": "/v3/publicaciones/somevalue" }, "rel2": { "href": "/v3/publicaciones/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Consultas": { "_links": { "rel1": { "href": "/v3/consultas/somevalue" }, "rel2": { "href": "/v3/consultas/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Visitas": { "_links": { "rel1": { "href": "/v3/visitas/somevalue" }, "rel2": { "href": "/v3/visitas/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "_links": { "rel1": { "href": "/v3/agencias/somevalue" }, "rel2": { "href": "/v3/agencias/somevalue", "method": "PUT" } } } ] } }, "eg_V3.Models.AgenciasRef": { "value": { "_links": { "rel1": { "href": "/v3/agencias?someparam=somevalue" }, "rel2": { "href": "/v3/agencias?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "AdminMail": "franco@superautos.com", "href": "/v3/agencias/franco@superautos.com", "title": "Super Autos" }, { "AdminMail": "emilio@grandesautos.com", "href": "/v3/agencias/emilio@grandesautos.com", "title": "Grandes Autos" } ] } }, "eg_V3.Models.AgenciaProductos": { "value": { "Baja": { "Pack": 30, "Activas": 10, "Disponibles": 20 }, "Media": { "Pack": 0, "Activas": 0, "Disponibles": 0 }, "Alta": { "Pack": 0, "Activas": 0, "Disponibles": 0 }, "_links": { "rel1": { "href": "/v3/agencias/somevalue" } } } }, "eg_V3.Models.AgenciaCreate": { "value": { "AdminMail": "franco@superautos.com", "NombreComercial": "Super Autos", "Region": "IT-MO", "Ciudad": "Maranello", "Direccion": "Av. Siempreviva 742", "Telefono": "+xx 9xx 12345678", "AdminNombre": "Franco", "AdminApellido": "Ghigliermini" } }, "eg_V3.Models.AgenciaEdit": { "value": { "NombreComercial": "Mi nuevo nombre" } }, "eg_V3.Models.AppWebhook": { "value": { "Callback": "https://callbacks.myapp.com/autocosmos/event", "Secret": null, "Description": "Mi callback para algo", "Activo": true, "HeaderCustom01": { "Name": "X-MYAPP-PRODUCER", "Value": "Autocosmos" }, "HeaderCustom02": null, "HeaderCustom03": null, "_links": { "rel1": { "href": "/v3/appnotificaciones/somevalue" }, "rel2": { "href": "/v3/appnotificaciones/somevalue", "method": "PUT" } } } }, "eg_V3.Models.AppWebhookUpsert": { "value": { "Callback": "https://callbacks.myapp.com/autocosmos/event", "Secret": null, "Description": "Mi callback para algo", "Activo": true, "HeaderCustom01": { "Name": "X-MYAPP-PRODUCER", "Value": "Autocosmos" }, "HeaderCustom02": null, "HeaderCustom03": null } }, "eg_V3.Models.AppWebhooks": { "value": { "TopicsDisponibles": [ "topic01", "topic02" ], "TopicsConfigurados": [ { "Topic": "topic02", "Config": { "Callback": "https://callbacks.myapp.com/autocosmos/event", "Secret": null, "Description": "Mi callback para algo", "Activo": true, "HeaderCustom01": { "Name": "X-MYAPP-PRODUCER", "Value": "Autocosmos" }, "HeaderCustom02": null, "HeaderCustom03": null, "_links": { "rel1": { "href": "/v3/appnotificaciones/somevalue" }, "rel2": { "href": "/v3/appnotificaciones/somevalue", "method": "PUT" } } } } ], "_links": { "self": { "rel1": { "href": "/v3/appnotificaciones/somevalue" } } } } }, "eg_V3.Models.NotificacionesConfig": { "value": { "PublicacionConsultadaWebHook": { "Callback": "https://callbacks.myapp.com/leads/listener/autocosmos", "Secret": null, "Activo": true, "HeaderCustom01": { "Name": "X-MYAPP-DEALERCODE", "Value": "I25_97" }, "HeaderCustom02": { "Name": "X-MYAPP-PRODUCER", "Value": "Autocosmos" }, "HeaderCustom03": null }, "PublicacionConsultadaAdfHook": { "Callback": "https://callbacks.myapp.com/leads/listener/adf", "Activo": true, "HeaderCustom01": { "Name": "X-MYAPP-DEALERCODE", "Value": "I25_97" } }, "PublicacionConsultadaAdfMail": { "Email": "leads.adf@myapp.com", "Activo": false }, "PublicacionConsultadaHtmlMail": { "EmailsCCO": "supervisor@agencia.com, super.supervisor@agencia.com, bigbrother@agencia.com", "Activo": true }, "_links": { "rel1": { "href": "/v3/notificaciones/somevalue" }, "rel2": { "href": "/v3/notificaciones/somevalue", "method": "PUT" } } } }, "eg_V3.Models.Sucursal": { "value": { "Descripcion": "Sede central", "Email": "sac@agencia.com", "Telefono": "+xx 9xx 67895432", "Region": "IT-MO", "Ciudad": "/v3/ciudades/1234", "Direccion": "Av. Siempreviva 742", "Comercial": true, "TallerMecanico": false, "Autopartes": false, "Laborable": { "Desde": "08:00:00", "Hasta": "19:00:00" }, "PreFestivo": { "Desde": "09:00:00", "Hasta": "14:00:00" }, "Festivo": null, "ResponsableLeadsPostVenta": null, "_links": { "rel1": { "href": "/v3/sucursales/somevalue" }, "rel2": { "href": "/v3/sucursales/somevalue", "method": "PUT" } } } }, "eg_V3.Models.SucursalRef": { "value": { "href": "/v3/sucursales/somevalue", "title": "Sede central (Av. Siempreviva 742, Maranello, Modena)" } }, "eg_V3.Models.Sucursales": { "value": { "_links": { "rel1": { "href": "/v3/sucursales?someparam=somevalue" }, "rel2": { "href": "/v3/sucursales?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "Descripcion": "Sede central", "Email": "sac@agencia.com", "Telefono": "+xx 9xx 67895432", "Region": "Modena", "Ciudad": "Maranello", "Direccion": "Av. Siempreviva 742", "Comercial": true, "TallerMecanico": false, "Autopartes": false, "Laborable": { "Desde": "08:00:00", "Hasta": "19:00:00" }, "PreFestivo": { "Desde": "09:00:00", "Hasta": "14:00:00" }, "Festivo": null, "ResponsableLeadsPostVenta": null, "_links": { "rel1": { "href": "/v3/sucursales/somevalue" }, "rel2": { "href": "/v3/sucursales/somevalue", "method": "PUT" } } }, { "Descripcion": "Service", "Email": "postventa@agencia.com", "Telefono": "+xx 9xx 73784230", "Region": "Modena", "Ciudad": "Castelvetro", "Direccion": "Av. Walter Chrysler 70", "Comercial": false, "TallerMecanico": true, "Autopartes": true, "Laborable": { "Desde": "08:00:00", "Hasta": "17:00:00" }, "PreFestivo": { "Desde": "09:00:00", "Hasta": "13:00:00" }, "Festivo": null, "ResponsableLeadsPostVenta": "miguel.postventa@agencia.com", "_links": { "rel1": { "href": "/v3/sucursales/somevalue" }, "rel2": { "href": "/v3/sucursales/somevalue", "method": "PUT" } } } ] } }, "eg_V3.Models.SucursalesRef": { "value": { "_links": { "rel1": { "href": "/v3/sucursales?someparam=somevalue" }, "rel2": { "href": "/v3/sucursales?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "href": "/v3/sucursales/somevalue", "title": "Sede central" }, { "href": "/v3/sucursales/somevalue", "title": "Service" } ] } }, "eg_V3.Models.Operador": { "value": { "Nombre": "Mario", "Apellido": "Rossi", "Email": "marior@agencia.com", "Telefonos": [ "+xx 9xx 67895432" ], "Direcciones": [ { "Region": "Modena", "Ciudad": "Maranello", "Direccion": "Av. Siempreviva 742" } ], "EsAdministradorAgencia": true, "Publicaciones": { "_links": { "rel1": { "href": "/v3/publicaciones/somevalue" }, "rel2": { "href": "/v3/publicaciones/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Consultas": { "_links": { "rel1": { "href": "/v3/consultas/somevalue" }, "rel2": { "href": "/v3/consultas/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "_links": { "rel1": { "href": "/v3/operadores/somevalue" }, "rel2": { "href": "/v3/operadores/somevalue", "method": "PUT" } } } }, "eg_V3.Models.OperadorRef": { "value": { "href": "/v3/operadores/marior@agencia.com?operador=marior@agencia.com", "title": "Mario Rossi (marior@agencia.com)" } }, "eg_V3.Models.Operadores": { "value": { "_links": { "rel1": { "href": "/v3/operadores?someparam=somevalue" }, "rel2": { "href": "/v3/operadores?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "Nombre": "Mario", "Apellido": "Rossi", "Email": "marior@agencia.com", "Telefonos": [ "+xx 9xx 67895432" ], "Direcciones": [ { "Region": "Modena", "Ciudad": "Maranello", "Direccion": "Av. Siempreviva 742" } ], "EsAdministradorAgencia": true, "Publicaciones": { "_links": { "rel1": { "href": "/v3/publicaciones/somevalue" }, "rel2": { "href": "/v3/publicaciones/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Consultas": { "_links": { "rel1": { "href": "/v3/consultas/somevalue" }, "rel2": { "href": "/v3/consultas/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "_links": { "rel1": { "href": "/v3/operadores/somevalue" }, "rel2": { "href": "/v3/operadores/somevalue", "method": "PUT" } } }, { "Nombre": "Carlo", "Apellido": "Bianchi", "Email": "carlob@agencia.com", "Telefonos": [ "+xx 9xx 67895443" ], "Direcciones": [ { "Region": "Modena", "Ciudad": "Maranello", "Direccion": "Av. Siempreviva 742" } ], "EsAdministradorAgencia": false, "Publicaciones": { "_links": { "rel1": { "href": "/v3/publicaciones/somevalue" }, "rel2": { "href": "/v3/publicaciones/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "Consultas": { "_links": { "rel1": { "href": "/v3/consultas/somevalue" }, "rel2": { "href": "/v3/consultas/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "_links": { "rel1": { "href": "/v3/operadores/somevalue" }, "rel2": { "href": "/v3/operadores/somevalue", "method": "PUT" } } } ] } }, "eg_V3.Models.OperadoresRef": { "value": { "_links": { "rel1": { "href": "/v3/operadores?someparam=somevalue" }, "rel2": { "href": "/v3/operadores?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "href": "/v3/operadores/marior@agencia.com?operador=marior@agencia.com", "title": "Mario Rossi (marior@agencia.com)" }, { "href": "/v3/operadores/marior@agencia.com?operador=carlob@agencia.com", "title": "Carlo Bianchi (carlob@agencia.com)" } ] } }, "eg_V3.Models.OperadorEdit": { "value": { "Nombre": "Mario", "Apellido": "Rossi", "TelefonoLaboral": null, "WhatsApp": "+xx 9xx 67895432", "Region": "IT-MO", "Ciudad": "/v3/ciudades/1234", "Direccion": "Av. Siempreviva 742" } }, "eg_V3.Models.Consulta": { "value": { "Momento": "2026-05-16T23:54:29.2252641+00:00", "OrigenLead": "form", "TipoAnuncio": "publicacion", "Auto": { "ExternalId": "ACD76543", "RefStock": null, "Marca": "Ford", "Modelo": "T", "Version": "Touring", "VersionYear": 1912, "Kilometraje": 356000, "Color": "Rojo", "BodyType": "Coupe", "Estado": "usado", "Precio": { "Moneda": "USD", "Importe": 800 }, "Anticipo": null, "Cuota": null }, "Interesado": { "Interes": "compra", "Nombre": "Francisco", "Apellido": "Garcia", "Email": "fragarcia@xmail.com", "Telefono": null, "DocIdentidad": null, "Provincia": "Modena", "Ciudad": null, "Comentario": "Me interesa esta publicación.", "InfoOperacion": { "EntregaVehiculo": { "Marca": "Ford", "Modelo": "A", "VersionYear": null }, "FinanciacionDeseada": { "Adelanto": null, "Cuota": { "Moneda": "USD", "Importe": 150 } }, "QuiereCotizacionSeguro": null } }, "OperadorResponsable": "franco@superautos.com", "_links": { "rel1": { "href": "/v3/consultas/somevalue" } } } }, "eg_V3.Models.ConsultaRef": { "value": { "href": "/v3/consultas/somevalue", "title": "mariobianchi@xmail.com - Ford T - ACD12345" } }, "eg_V3.Models.Consultas": { "value": { "Desde": "2026-02-15T00:00:00+00:00", "Hasta": "2026-05-16T23:59:59.996+00:00", "Pagina": 1, "Total": 2, "PerPagina": 100, "_links": { "rel1": { "href": "/v3/consultas?someparam=somevalue" }, "rel2": { "href": "/v3/consultas?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "Momento": "2026-05-16T23:54:29.225322+00:00", "OrigenLead": "form", "TipoAnuncio": "publicacion", "Auto": { "ExternalId": "ACD76543", "RefStock": null, "Marca": "Ford", "Modelo": "T", "Version": "Touring", "VersionYear": 1912, "Kilometraje": 356000, "Color": "Rojo", "BodyType": "Coupe", "Estado": "usado", "Precio": { "Moneda": "USD", "Importe": 800 }, "Anticipo": null, "Cuota": null }, "Interesado": { "Interes": "compra", "Nombre": "Francisco", "Apellido": "Garcia", "Email": "fragarcia@xmail.com", "Telefono": null, "DocIdentidad": null, "Provincia": "Modena", "Ciudad": null, "Comentario": "Me interesa esta publicación.", "InfoOperacion": { "EntregaVehiculo": { "Marca": "Ford", "Modelo": "A", "VersionYear": null }, "FinanciacionDeseada": { "Adelanto": null, "Cuota": { "Moneda": "USD", "Importe": 150 } }, "QuiereCotizacionSeguro": null } }, "OperadorResponsable": "franco@superautos.com", "_links": { "rel1": { "href": "/v3/consultas/somevalue" } } }, { "Momento": "2026-05-16T23:54:29.2253247+00:00", "OrigenLead": "form", "TipoAnuncio": "catalogo", "Auto": { "ExternalId": "", "RefStock": null, "Marca": "Ferrari", "Modelo": "F360", "Version": null, "VersionYear": null, "Kilometraje": null, "Color": null, "BodyType": null, "Estado": "nuevo", "Precio": null, "Anticipo": null, "Cuota": null }, "Interesado": { "Interes": "compra", "Nombre": "Gilles", "Apellido": "Villeneuve", "Email": "velodromecarpark@skycloud.com", "Telefono": null, "DocIdentidad": null, "Provincia": "Modena", "Ciudad": null, "Comentario": "Me interesa esta publicación.", "InfoOperacion": null }, "OperadorResponsable": "franco@superautos.com", "_links": { "rel1": { "href": "/v3/consultas/somevalue" } } } ] } }, "eg_V3.Models.ConsultasRef": { "value": { "Desde": "2026-02-15T00:00:00+00:00", "Hasta": "2026-05-16T23:59:59.996+00:00", "Pagina": 1, "Total": 2, "PerPagina": 100, "_links": { "rel1": { "href": "/v3/consultas?someparam=somevalue" }, "rel2": { "href": "/v3/consultas?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "href": "/v3/consultas/somevalue", "title": "mariobianchi@xmail.com - Ford T - ACD12345" }, { "href": "/v3/consultas/somevalue", "title": "paolo.rossi@xmail.com - Ferrari F40 - ACD76543" } ] } }, "eg_V3.Models.VisitasDiarias": { "value": { "Year": 2021, "Month": 8, "Day": null, "_truncated": false, "_entries": [ { "ExtenalId": "ACD12345", "Dia": "2021-08-01", "Visitas": 789, "Whatsapp": 4 }, { "ExtenalId": "ACD76543", "Dia": "2021-08-01", "Visitas": 511, "Whatsapp": 7 }, { "ExtenalId": "ACD12345", "Dia": "2021-08-02", "Visitas": 456, "Whatsapp": 0 } ] } }, "eg_V3.Models.Carroceria": { "value": { "Nombre": "Coupé", "CodeName": "coupe", "_links": { "rel1": { "href": "/v3/carrocerias/somevalue" } } } }, "eg_V3.Models.Carrocerias": { "value": { "_links": { "rel1": { "href": "/v3/carrocerias?someparam=somevalue" }, "rel2": { "href": "/v3/carrocerias?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "Nombre": "Coupé", "CodeName": "coupe", "_links": { "rel1": { "href": "/v3/carrocerias/somevalue" } } }, { "Nombre": "Hatchback", "CodeName": "hatchback", "_links": { "rel1": { "href": "/v3/carrocerias/somevalue" } } } ] } }, "eg_V3.Models.Ciudad": { "value": { "Nombre": "Torino", "Region": "Torino", "_links": { "rel1": { "href": "/v3/ciudades/somevalue" } } } }, "eg_V3.Models.CiudadRef": { "value": { "href": "/v3/ciudades/somevalue", "title": "Maranello (Modena)" } }, "eg_V3.Models.Ciudades": { "value": { "_links": { "rel1": { "href": "/v3/ciudades?someparam=somevalue" }, "rel2": { "href": "/v3/ciudades?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "Nombre": "Torino", "Region": "Torino", "_links": { "rel1": { "href": "/v3/ciudades/somevalue" } } }, { "Nombre": "Maranello", "Region": "Modena", "_links": { "rel1": { "href": "/v3/ciudades/somevalue" } } } ] } }, "eg_V3.Models.CiudadesRef": { "value": { "_links": { "rel1": { "href": "/v3/ciudades?someparam=somevalue" }, "rel2": { "href": "/v3/ciudades?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "href": "/v3/ciudades/somevalue", "title": "Maranello (Emilia Romagna)" }, { "href": "/v3/ciudades/somevalue", "title": "Torino (Piemonte)" } ] } }, "eg_V3.Models.Color": { "value": { "Nombre": "Blue", "HtmlColor": "#0000ff", "_links": { "rel1": { "href": "/v3/colores/somevalue" } } } }, "eg_V3.Models.ColorRef": { "value": { "href": "/v3/colores/somevalue", "title": "Blue" } }, "eg_V3.Models.Colores": { "value": { "_links": { "rel1": { "href": "/v3/colores?someparam=somevalue" }, "rel2": { "href": "/v3/colores?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "Nombre": "Blue", "HtmlColor": "#0000ff", "_links": { "rel1": { "href": "/v3/colores/somevalue" } } }, { "Nombre": "Rojo", "HtmlColor": "#FF2800", "_links": { "rel1": { "href": "/v3/colores/somevalue" } } } ] } }, "eg_V3.Models.ColoresRef": { "value": { "_links": { "rel1": { "href": "/v3/colores?someparam=somevalue" }, "rel2": { "href": "/v3/colores?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "href": "/v3/colores/somevalue", "title": "Blue" }, { "href": "/v3/colores/somevalue", "title": "Rojo" } ] } }, "eg_V3.Models.Marca": { "value": { "Nombre": "Ferrari", "Codenames": [ "ferrari" ], "Modelos": { "_links": { "rel1": { "href": "/v3/modelos/somevalue" }, "rel2": { "href": "/v3/modelos/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "_links": { "rel1": { "href": "/v3/marcas/somevalue" } } } }, "eg_V3.Models.MarcaRef": { "value": { "href": "/v3/marcas/somevalue", "title": "Ferrari" } }, "eg_V3.Models.Marcas": { "value": { "_links": { "rel1": { "href": "/v3/marcas?someparam=somevalue" }, "rel2": { "href": "/v3/marcas?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "Nombre": "Ferrari", "Codenames": [ "ferrari" ], "Modelos": { "_links": { "rel1": { "href": "/v3/modelos/somevalue" }, "rel2": { "href": "/v3/modelos/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "_links": { "rel1": { "href": "/v3/marcas/somevalue" } } }, { "Nombre": "Mercedes", "Codenames": [ "mercedes", "mercedes-benz" ], "Modelos": { "_links": { "rel1": { "href": "/v3/modelos/somevalue" }, "rel2": { "href": "/v3/modelos/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "_links": { "rel1": { "href": "/v3/marcas/somevalue" } } } ] } }, "eg_V3.Models.MarcasRef": { "value": { "_links": { "rel1": { "href": "/v3/marcas?someparam=somevalue" }, "rel2": { "href": "/v3/marcas?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "href": "/v3/marcas/somevalue", "title": "Ferrari" }, { "href": "/v3/marcas/somevalue", "title": "Mercedes" } ] } }, "eg_V3.Models.Modelo": { "value": { "Marca": "Ferrari", "Nombre": "F360", "Codename": "f360", "Carrocerias": [ "convertible", "coupe" ], "Versiones": { "_links": { "rel1": { "href": "/v3/versiones/somevalue" }, "rel2": { "href": "/v3/versiones/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "_links": { "rel1": { "href": "/v3/modelos/somevalue" } } } }, "eg_V3.Models.ModeloRef": { "value": { "href": "/v3/modelos/somevalue", "title": "F360" } }, "eg_V3.Models.Modelos": { "value": { "_links": { "rel1": { "href": "/v3/modelos?someparam=somevalue" }, "rel2": { "href": "/v3/modelos?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "Marca": "Ferrari", "Nombre": "F360", "Codename": "f360", "Carrocerias": [ "convertible", "coupe" ], "Versiones": { "_links": { "rel1": { "href": "/v3/versiones/somevalue" }, "rel2": { "href": "/v3/versiones/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "_links": { "rel1": { "href": "/v3/modelos/somevalue" } } }, { "Marca": "Ferrari", "Nombre": "F456", "Codename": "f456", "Carrocerias": [ "coupe" ], "Versiones": { "_links": { "rel1": { "href": "/v3/versiones/somevalue" }, "rel2": { "href": "/v3/versiones/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "_links": { "rel1": { "href": "/v3/modelos/somevalue" } } } ] } }, "eg_V3.Models.ModelosRef": { "value": { "_links": { "rel1": { "href": "/v3/modelos?someparam=somevalue" }, "rel2": { "href": "/v3/modelos?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "href": "/v3/modelos/somevalue", "title": "F360" }, { "href": "/v3/modelos/somevalue", "title": "F456" } ] } }, "eg_V3.Models.Version": { "value": { "VersionYear": null, "Propulsion": "gasolina", "Transmision": "Manual", "Potencia": "540 cv", "Cilindrada": "5.7L", "Marca": "Ferrari", "Modelo": "F612", "Nombre": "Scaglietti", "Codename": "scaglietti", "Carroceria": "Coupé", "Segmento": "C", "_links": { "rel1": { "href": "/v3/versiones/somevalue" } } } }, "eg_V3.Models.VersionRef": { "value": { "Marca": "Ferrari", "Modelo": "F612", "Version": "Scaglietti", "VersionYear": null, "href": "/v3/versiones/12345", "title": "Ferrari F612 Scaglietti" } }, "eg_V3.Models.VersionEx": { "value": { "VersionYear": 2019, "Origen": "Italia", "Garantia": "No disponible", "Foto": "https://somedomain/somefolder/foto.jpg", "Precio": null, "Colores": [], "ActualmenteDisponible": false, "InfoTecnica": [ { "Seccion": "Motor", "Valor": "Combustible", "Datos": "gasolina" }, { "Seccion": "Motor", "Valor": "Cilindrada", "Datos": "5748 cc" }, { "Seccion": "Confort", "Valor": "Asientos delanteros", "Datos": "con ajuste eléctrico y memorias, con ajuste en altura solo conductor" }, { "Seccion": "Confort", "Valor": "Tapizados", "Datos": "cuero" } ], "Marca": "Ferrari", "Modelo": "F612", "Nombre": "Scaglietti", "Codename": "scaglietti", "Carroceria": "Coupé", "Segmento": "C", "_links": { "rel1": { "href": "/v3/versiones/somevalue" } } } }, "eg_V3.Models.Versiones": { "value": { "_links": { "rel1": { "href": "/v3/versiones?someparam=somevalue" }, "rel2": { "href": "/v3/versiones?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "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": { "rel1": { "href": "/v3/versiones/somevalue" } } }, { "VersionYear": null, "Propulsion": "gasolina", "Transmision": "Manual", "Potencia": null, "Cilindrada": null, "Marca": "Ferrari", "Modelo": "F360", "Nombre": "Spider", "Codename": "spider", "Carroceria": "Convertible", "Segmento": "C", "_links": { "rel1": { "href": "/v3/versiones/somevalue" } } } ] } }, "eg_V3.Models.VersionesRef": { "value": { "_links": { "rel1": { "href": "/v3/versiones?someparam=somevalue" }, "rel2": { "href": "/v3/versiones?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "Marca": "Ferrari", "Modelo": "F360", "Version": "Modena F1", "VersionYear": null, "href": "/v3/versiones/7890", "title": "Ferrari F360 Modena F1" }, { "Marca": "Ferrari", "Modelo": "F360", "Version": "Spider", "VersionYear": null, "href": "/v3/versiones/7895", "title": "Ferrari F360 Spider" } ] } }, "eg_V3.Models.VersionMatch": { "value": { "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" } } ] } }, "eg_V3.Models.Moneda": { "value": { "Nombre": "Dólares", "Iso": "USD", "Simbolo": "u$s", "_links": { "rel1": { "href": "/v3/monedas/somevalue" } } } }, "eg_V3.Models.Monedas": { "value": { "_links": { "rel1": { "href": "/v3/monedas?someparam=somevalue" }, "rel2": { "href": "/v3/monedas?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "Nombre": "Dólares", "Iso": "USD", "Simbolo": "u$s", "_links": { "rel1": { "href": "/v3/monedas/somevalue" } } }, { "Nombre": "Euros", "Iso": "EUR", "Simbolo": "€", "_links": { "rel1": { "href": "/v3/monedas/somevalue" } } } ] } }, "eg_V3.Models.Propulsion": { "value": { "Nombre": "diesel", "_links": { "rel1": { "href": "/v3/propulsiones/somevalue" } } } }, "eg_V3.Models.Propulsiones": { "value": { "_links": { "rel1": { "href": "/v3/propulsiones?someparam=somevalue" }, "rel2": { "href": "/v3/propulsiones?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "Nombre": "diesel", "_links": { "rel1": { "href": "/v3/propulsiones/somevalue" } } }, { "Nombre": "eléctrico", "_links": { "rel1": { "href": "/v3/propulsiones/somevalue" } } } ] } }, "eg_V3.Models.Region": { "value": { "Nombre": "Modena", "Iso": "IT-MO", "Ciudades": { "_links": { "rel1": { "href": "/v3/ciudades/somevalue" }, "rel2": { "href": "/v3/ciudades/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "_links": { "rel1": { "href": "/v3/regiones/somevalue" } } } }, "eg_V3.Models.RegionRef": { "value": { "href": "/v3/regiones/somevalue", "title": "Modena" } }, "eg_V3.Models.Regiones": { "value": { "_links": { "rel1": { "href": "/v3/regiones?someparam=somevalue" }, "rel2": { "href": "/v3/regiones?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "Nombre": "Modena", "Iso": "IT-MO", "Ciudades": { "_links": { "rel1": { "href": "/v3/ciudades/somevalue" }, "rel2": { "href": "/v3/ciudades/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "_links": { "rel1": { "href": "/v3/regiones/somevalue" } } }, { "Nombre": "Torino", "Iso": "IT-TO", "Ciudades": { "_links": { "rel1": { "href": "/v3/ciudades/somevalue" }, "rel2": { "href": "/v3/ciudades/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "_links": { "rel1": { "href": "/v3/regiones/somevalue" } } } ] } }, "eg_V3.Models.RegionesRef": { "value": { "_links": { "rel1": { "href": "/v3/regiones?someparam=somevalue" }, "rel2": { "href": "/v3/regiones?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "href": "/v3/regiones/somevalue", "title": "Modena" }, { "href": "/v3/regiones/somevalue", "title": "Torino" } ] } }, "eg_V3.Models.Publicacion": { "value": { "ExternalId": "ACD12345", "RefStock": "x879", "Vin": "2FAFP71W33X139410", "EstadoActual": "Activa", "Exposicion": "Baja", "OperadorResponsable": "franco@superautos.com", "Marca": "BMW", "Modelo": "Serie 3", "Version": "330I SEDAN SPORT LINE", "VersionYear": 2016, "Transmision": "Manual", "Propulsion": "gasolina", "Kilometraje": 112000, "Color": "Azul", "Descripcion": "Muy buen estado. Servicios realizados en agencia oficial.", "DatosTecnicosCustom": [], "Precio": { "Moneda": "USD", "Importe": 29500 }, "Adelanto": null, "Cuota": null, "Fotos": [ "https://somedomain/somefolder/foto1.jpg", "https://somedomain/somefolder/foto2.jpg" ], "CertificadoDeGarantiaUsado": null, "Locacion": { "Region": "Modena", "Ciudad": "Maranello", "Direccion": "Av. Siempreviva 742" }, "Telefono": "+xx 9xx 12345678", "Consultas": { "_links": { "rel1": { "href": "/v3/consultas/somevalue" }, "rel2": { "href": "/v3/consultas/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "_links": { "rel1": { "href": "/v3/publicaciones/somevalue" }, "rel2": { "href": "/v3/publicaciones/somevalue", "method": "PUT" } } } }, "eg_V3.Models.PublicacionRef": { "value": { "etag": "uDUbRssKWk2r70O5FM7+xvzVGGXBiNkI", "ExternalId": "ACD12345", "EstadoActual": "Activa", "href": "/v3/publicaciones/franco@superautos.com/ACD12345", "title": "BMW Serie 3 330I SEDAN SPORT LINE (2016)" } }, "eg_V3.Models.Publicaciones": { "value": { "Pagina": 1, "Total": 0, "PerPagina": 0, "_links": { "rel1": { "href": "/v3/publicaciones?someparam=somevalue" }, "rel2": { "href": "/v3/publicaciones?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "ExternalId": "ACD12345", "RefStock": "x879", "Vin": "2FAFP71W33X139410", "EstadoActual": "Activa", "Exposicion": "Baja", "OperadorResponsable": "franco@superautos.com", "Marca": "BMW", "Modelo": "Serie 3", "Version": "330I SEDAN SPORT LINE", "VersionYear": 2016, "Transmision": "Manual", "Propulsion": "gasolina", "Kilometraje": 112000, "Color": "Azul", "Descripcion": "Muy buen estado. Servicios realizados en agencia oficial.", "DatosTecnicosCustom": [], "Precio": { "Moneda": "USD", "Importe": 29500 }, "Adelanto": null, "Cuota": null, "Fotos": [ "https://somedomain/somefolder/foto1.jpg", "https://somedomain/somefolder/foto2.jpg" ], "CertificadoDeGarantiaUsado": null, "Locacion": { "Region": "Modena", "Ciudad": "Maranello", "Direccion": "Av. Siempreviva 742" }, "Telefono": "+xx 9xx 12345678", "Consultas": { "_links": { "rel1": { "href": "/v3/consultas/somevalue" }, "rel2": { "href": "/v3/consultas/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "_links": { "rel1": { "href": "/v3/publicaciones/somevalue" }, "rel2": { "href": "/v3/publicaciones/somevalue", "method": "PUT" } } }, { "ExternalId": "ACD76543", "RefStock": "x978", "Vin": "", "EstadoActual": "Suspendida", "Exposicion": "Alta", "OperadorResponsable": "franco@superautos.com", "Marca": "BMW", "Modelo": "Serie 3", "Version": "320I SEDAN EXECUTIVE", "VersionYear": 2017, "Transmision": "Manual", "Propulsion": "gasolina", "Kilometraje": 35800, "Color": "Gris", "Descripcion": "Petacular!!", "DatosTecnicosCustom": [], "Precio": { "Moneda": "USD", "Importe": 33900 }, "Adelanto": null, "Cuota": null, "Fotos": [ "https://somedomain/somefolder/xfoto1.jpg", "https://somedomain/somefolder/xfoto2.jpg" ], "CertificadoDeGarantiaUsado": "Stai sereno", "Locacion": { "Region": "Modena", "Ciudad": "Maranello", "Direccion": "Av. Siempreviva 742" }, "Telefono": "+xx 9xx 12345678", "Consultas": { "_links": { "rel1": { "href": "/v3/consultas/somevalue" }, "rel2": { "href": "/v3/consultas/somevalue?param1={param1}¶m2={param2}", "templated": true } } }, "_links": { "rel1": { "href": "/v3/publicaciones/somevalue" }, "rel2": { "href": "/v3/publicaciones/somevalue", "method": "PUT" } } } ] } }, "eg_V3.Models.PublicacionesRef": { "value": { "Pagina": 1, "Total": 0, "PerPagina": 0, "_links": { "rel1": { "href": "/v3/publicaciones?someparam=somevalue" }, "rel2": { "href": "/v3/publicaciones?param1={param1}¶m2={param2}", "templated": true } }, "_entries": [ { "etag": "uDUbRssKWk2r70O5FM7+xvzVGGXBiNkI", "ExternalId": "ACD12345", "EstadoActual": "Activa", "href": "/v3/publicaciones/franco@superautos.com/ACD12345", "title": "BMW Serie 3 330I SEDAN SPORT LINE (2016)" }, { "etag": "krF1xLdcY0izv3Kk8CcDDTQSgmLhk9kI", "ExternalId": "ACD76543", "EstadoActual": "Suspendida", "href": "/v3/publicaciones/franco@superautos.com/ACD76543", "title": "BMW Serie 3 320I SEDAN EXECUTIVE (2017)" } ] } }, "eg_V3.Models.PublicacionEdit": { "value": { "RefStock": "x879", "Vin": null, "Activa": true, "Exposicion": "Media", "OperadorResponsable": null, "VersionYear": 2016, "Kilometraje": 112000, "Color": "Azul", "Descripcion": "Muy buen estado. Servicios realizados en agencia oficial.", "DatosTecnicosCustom": [], "Precio": { "Moneda": "USD", "Importe": 29500 }, "Adelanto": null, "Cuota": null, "Fotos": [ "https://somedomain/somefolder/foto1.jpg", "https://somedomain/somefolder/foto2.jpg" ], "AplicaCertificadoGarantiaUsado": false, "Locacion": { "Region": "IT-MO", "Ciudad": "Maranello", "Direccion": "Av. Siempreviva 742" }, "Telefono": "+xx 9xx 12345678" } }, "eg_V3.Models.PublicacionPartialEdit": { "value": { "Precio": null, "Adelanto": { "Moneda": "USD", "Importe": 15900 }, "Cuota": null, "Activa": true } }, "eg_V3.Models.PublicacionCreate": { "value": { "ExternalId": "ACD12345", "RefStock": "x879", "Vin": "1GCGG25V571190263", "Activa": true, "Exposicion": null, "OperadorResponsable": null, "Marca": "BMW", "Modelo": "Serie 3", "Version": "330I SEDAN SPORT LINE", "VersionYear": 2016, "Transmision": "Manual", "Propulsion": "gasolina", "Carroceria": "Sedan", "Kilometraje": 112000, "Color": "Azul", "Descripcion": "Muy buen estado. Servicios realizados en agencia oficial.", "DatosTecnicosCustom": [ "cierre centralizado", "levanta vidrios electricos" ], "Precio": { "Moneda": "USD", "Importe": 29500 }, "Adelanto": null, "Cuota": null, "Fotos": [ "https://tu_public_domain/somefolder/foto1.jpg", "https://tu_public_domain/somefolder/foto2.jpg" ], "AplicaCertificadoGarantiaUsado": false, "Locacion": null, "Telefono": null } } } }, "tags": [ { "name": "Agencias", "description": "Gestión de agencias/concesionarios asociado a tu app." }, { "name": "AppNotificaciones", "description": "Gestión de notificaciones asociadas a tu app." }, { "name": "Carrocerias", "description": "Carrocerías (aka body-styles)." }, { "name": "Ciudades", "description": "Queries de ciudades." }, { "name": "Colores", "description": "Queries de colores de autos." }, { "name": "Consultas", "description": "Consultas recibidas." }, { "name": "Home", "description": "Home de la API.\r\nPara surfing de la API tal vez te convenga empezar por acá usando la \"Play-station\".\r\nSi logras navegar la API sin conocer las URLs, dejandote llevar por los '_links', tal vez descubras\r\nque no es necesario guardar muchas Urls y paths en tu código; tal vez las 'relationship' (nombres de propiedades del object '_links')\r\nsean las que ayuden.\r\nTal vez descubras que, si tu código empieza por la home de la API, logres navegarla solo conociendo los nombres de propiedades de las entidades que se quiere gestionar." }, { "name": "Marcas", "description": "Marcas de autos." }, { "name": "Modelos", "description": "Modelos de una marca." }, { "name": "Monedas", "description": "Monedas por país según las comúnmente usadas para la compra/venta de autos." }, { "name": "Notificaciones", "description": "Gestión de notificaciones de agencias/concesionarios.\r\nAgencias y colaboradores pueden tener activas múltiples notificaciones asociadas a varios eventos de su cuenta.\r\nUna app, por API, solo puede gestionar notificaciones relacionadas a la publicaciones de la agencia, en general, o del administrador de la cuenta (solo activación desactivación mails HTML)." }, { "name": "Operadores", "description": "Gestión operadores de agencias/concesionarios." }, { "name": "Propulsiones", "description": "Propulsiones (aka combustibles)." }, { "name": "Publicaciones", "description": "Gestión de agencias/concesionarios asociado a tu app, asociación o grupo." }, { "name": "Regiones", "description": "Queries de provicias, estados, regiones etc." }, { "name": "Sucursales", "description": "Gestión de sucursales de agencias/concesionarios." }, { "name": "Tests", "description": "Operaciones de prueba. Úsalo para verificar que tu client tiene acceso y esta bien implementada la autenticación basada en HMAC." }, { "name": "Versiones", "description": "Queries de versiones de modelos de autos." }, { "name": "Visitas", "description": "Queries de visitas." } ] }