Endpoint Veículo

1 - Inserir veículos no sistema do Auto Business

Requisição

POST https://api.autobusiness.com.br/api/v1/veiculos
Autenticação: Token Bearer

Parâmetros

  • idMarca: (int)* id referente a marca
  • idModelo: (int)* id referente ao modelo
  • anoFabricacao: (int)* ano de fabricação
  • anoModelo: (int)* ano de modelo
  • preco: (float)* valor do veículo
  • idCombustivel: (int) id referente ao combustível
  • idTransmissao: (int) id referente ao tipo de câmbio
  • idSensor: (int) id referente ao tipo de sensor de estacionamento
  • idCamera: (int) id referente aos tipos de câmera disponíveis
  • idVeiculoCategoria: (int) id referente a categoria do veículo
  • idVeiculoTipo: (int) id referente ao tipo de veículo
  • idConservacao: (int) id referente ao estado de conservação do veículo
  • idOrigem: (int) id referente a origem do veículo
  • versao: (varchar) versão do veículo
  • km: (int) quilometragem
  • motor: (varchar) especificações do motor do veículo
  • potencia: (varchar) potência em cavalos do veículo
  • aceleracao: (varchar) dados de aceleração do veículo
  • airbag: (int) quantidade de airbags
  • garantiaFabrica: (varchar) tempo de garantia de fábrica
  • placa: (varchar) placa
  • portas: quantidade de portas
  • multimidia: (varchar) especificações do multimidia
  • idCor: (int) id referente a cor externa
  • idCorSecundaria: (int) id referente a cor secundária
  • idCorInterna: (int) id referente a cor interna
  • bancos: (varchar) especificações dos bancos
  • freios: (varchar) especificações dos freios
  • farois: (varchar) tipo de farol
  • rodas: (varchar) aro da roda,
  • bluetooth: (boolean) true / false
  • tetoSolar: (boolean) true / false
  • conversivel: (boolean) true / false
  • pilotoAutomatico: (boolean) true / false
  • sensorChuva: (boolean) true / false
  • blindado: (boolean) true / false
  • observacoes: (varchar) observações e anotações
  • renavam: (int) número do renavam
  • chassi: (varchar) número do chassi
  • esconderPreco: (boolean) true / false
  • textoAlternativoPreco: (varchar) texto para ser mostrado ao invés do preço
  • album: (array) com links para imagens

Exemplos:


    curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d

    {
        "idMarca": 70,
        "idModelo": 1106,
        "idCombustivel": 3,
        "idTransmissao": 18,
        "idSensor": 8,
        "idCamera": 1,
        "idVeiculoCategoria": 3,
        "idVeiculoTipo": 1,
        "idConservacao": 1,
        "idOrigem": 2,
        "data": "2023-10-19 13:00:00",
        "versao": "GT3",
        "anoFabricacao": 2022,
        "anoModelo": 2023,
        "km": 1500,
        "motor": "4.0 Boxer 6 Cil",
        "potencia": "510cv",
        "aceleracao": "0 a 100 em 3,4 seg",
        "airbag": 4,
        "garantiaFabrica": "3 anos",
        "placa": "ABC1234",
        "portas": 2,
        "multimidia": "Sim - Com Apple CarPlay",
        "idCor": 505,
        "idCorSecundaria": 505,
        "idCorInterna": 505,
        "bancos": "Concha em Fibra de Carbono",
        "freios": "Carbono Cerâmica nas 4 rodas",
        "farois": "Full LED",
        "rodas": "Aro 20'/21'",
        "bluetooth": "true",
        "tetoSolar": "false",
        "conversivel": "false",
        "pilotoAutomatico": "false",
        "sensorChuva": "false",
        "blindado": "true",
        "observacoes": "Ultima revisão feita em julho de 2023",
        "renavam": "123",
        "chassi": "123",
        "preco": "2.500.000,00",
        "esconderPreco": "false",
        "textoAlternativoPreco": "Sob consulta",
        "album": [
            "https://files.porsche.com/filestore/image/multimedia/none/f479e140-4f65-4655-a344-11747ad652a2/normal/bfad2dca-8d79-11eb-80d4-005056bbdc38;sJ;twebp/porsche-normal.webp",
            "https://files.porsche.com/filestore/galleryimagerwd/multimedia/none/992-gt3-gallery-03/zoom2/59ea44db-4450-11eb-80d1-005056bbdc38;sH;twebp/porsche-zoom2.webp",
            "https://files.porsche.com/filestore/galleryimagerwd/multimedia/none/992-gt3-gallery-04/zoom2/2aab4506-8d72-11eb-80d4-005056bbdc38;sH;twebp/porsche-zoom2.webp"
        ]
    }

    https://api.autobusiness.com.br/api/v1/veiculos
            
        

    201 Created
    Content-Type: application/json
    {
        "Mensagem": "Veiculo criado com sucesso",
        "idVeiculo": 123456
    }
            
        

    401 Unauthorized
    Content-Type: application/json
    {
        "message": "Falha ao autenticar"
    }

2 - Listar todos os veículos cadastrados

Requisição

GET https://api.autobusiness.com.br/api/v1/veiculos/
Autenticação: Token Bearer

Parâmetros

Não são necessários parâmetros

Exemplos:


        200 OK
        Content-Type: application/json
        [
            {
                "idVeiculo": 13969,
                ...
            },
            {
                "idVeiculo": 13968,
                ...
            },
            {
                "idVeiculo": 13967,
                ...
            }...
        ]
    
        https://api.autobusiness.com.br/api/v1/veiculos
                
            

        401 Unauthorized
        Content-Type: application/json
        {
            "message": "Falha ao autenticar"
        }

3 - Listar apenas um veículo

Requisição

GET https://api.autobusiness.com.br/api/v1/veiculos/{id}
Autenticação: Token Bearer

Parâmetros

Não são necessários parâmetros

Exemplos:


        200 OK
        Content-Type: application/json
        [
            {
                "idVeiculo": 13969,
                "data": "2024-01-30 15:54:13",
                "dataAtualizacao": "2024-01-30 15:54:13",
                "idCliente": 0,
                "idUsuario": 0,
                "idBusiness": 114,
                "idBusinessUnidade": 121,
                "idMarca": 70,
                "idModelo": 1106,
                "Modelo": null,
                "versao": "GT3",
                "renavam": "123",
                "chassi": "123",
                "horas": "",
                "pes": "",
                "comprimento": "",
                "boca": "",
                "cabines": "",
                "banheiros": "",
                "tipoPropulssao": "",
                "acessorios": "",
                "subtitulo": "",
                "tipo": "veiculo",
                "alias": "porsche-911-gt3-2022-2023",
                "permalink": "",
                "preco": "2.500.000,00",
                "precoOferta": null,
                "textoAlternativoPreco": "Sob consulta",
                "esconderPreco": 1,
                "anoFabricacao": "2022",
                "anoModelo": "2023",
                "km": "1500",
                "tipoKm": 1,
                "motor": "4.0 Boxer 6 Cil",
                "potencia": "510cv",
                "aceleracao": "0 a 100 em 3,4 seg",
                "airbag": "4",
                "garantiaFabrica": "3 anos",
                "idCombustivel": 3,
                "idTransmissao": "18",
                "placa": "ABC1234",
                "portas": 2,
                "multimidia": "Sim - Com Apple CarPlay",
                "idCor": 505,
                "idCorSecundaria": 505,
                "idCorInterna": 505,
                "bancos": "Concha em Fibra de Carbono",
                "freios": "Carbono Cerâmica nas 4 rodas",
                "farois": "Full LED",
                "rodas": "Aro 20'/21'",
                "idSensor": "8",
                "idCamera": 1,
                "bluetooth": "sim",
                "tetoSolar": "nao",
                "conversivel": "nao",
                "pilotoAutomatico": "sim",
                "sensorChuva": "nao",
                "blindado": "sim",
                "idAlbum": 15640,
                "idAlbum360": null,
                "idVeiculoCategoria": 3,
                "idVeiculoTipo": 1,
                "idSegmento": null,
                "oferta": null,
                "tags": null,
                "capa": null,
                "idConservacao": 1,
                "idOrigem": 2,
                "anotacoes": null,
                "observacoes": "Ultima revisão feita em julho de 2023",
                "descricao": null,
                "ordem": null,
                "repasse": null,
                "status": 1,
                "idVeiculoCheckin": null,
                "video": null,
                "publicar": "sim",
                "album": [
                    {
                        "url": "https://files.porsche.com/filestore/image/multimedia/none/f479e140-4f65-4655-a344-11747ad652a2/normal/bfad2dca-8d79-11eb-80d4-005056bbdc38;sJ;twebp/porsche-normal.webp"
                    },
                    {
                        "url": "https://files.porsche.com/filestore/galleryimagerwd/multimedia/none/992-gt3-gallery-03/zoom2/59ea44db-4450-11eb-80d1-005056bbdc38;sH;twebp/porsche-zoom2.webp"
                    },
                    {
                        "url": "https://files.porsche.com/filestore/galleryimagerwd/multimedia/none/992-gt3-gallery-04/zoom2/2aab4506-8d72-11eb-80d4-005056bbdc38;sH;twebp/porsche-zoom2.webp"
                    }
                ]
            }
        ]
    
        https://api.autobusiness.com.br/api/v1/veiculos/13969
                
            

        401 Unauthorized
        Content-Type: application/json
        {
            "message": "Falha ao autenticar"
        }

4 - Atualizar veículo

Requisição

PUT https://api.autobusiness.com.br/api/v1/veiculos/{id}
Autenticação: Token Bearer

Parâmetros

Os mesmos parâmetros necessários no ponto 1 (Inserir veículo). Nenhum atributo é obrigátorio, mas caso precise alterar as imagens, é necessário colocar o link de todas novamente.

  • idMarca: (int) id referente a marca
  • idModelo: (int) id referente ao modelo
  • anoFabricacao: (int) ano de fabricação
  • anoModelo: (int) ano de modelo
  • preco: (float) valor do veículo
  • idCombustivel: (int) id referente ao combustível
  • idTransmissao: (int) id referente ao tipo de câmbio
  • idSensor: (int) id referente ao tipo de sensor de estacionamento
  • idCamera: (int) id referente aos tipos de câmera disponíveis
  • idVeiculoCategoria: (int) id referente a categoria do veículo
  • idVeiculoTipo: (int) id referente ao tipo de veículo
  • idConservacao: (int) id referente ao estado de conservação do veículo
  • idOrigem: (int) id referente a origem do veículo
  • versao: (varchar) versão do veículo
  • km: (int) quilometragem
  • motor: (varchar) especificações do motor do veículo
  • potencia: (varchar) potência em cavalos do veículo
  • aceleracao: (varchar) dados de aceleração do veículo
  • airbag: (int) quantidade de airbags
  • garantiaFabrica: (varchar) tempo de garantia de fábrica
  • placa: (varchar) placa
  • portas: quantidade de portas
  • multimidia: (varchar) especificações do multimidia
  • idCor: (int) id referente a cor externa
  • idCorSecundaria: (int) id referente a cor secundária
  • idCorInterna: (int) id referente a cor interna
  • bancos: (varchar) especificações dos bancos
  • freios: (varchar) especificações dos freios
  • farois: (varchar) tipo de farol
  • rodas: (varchar) aro da roda,
  • bluetooth: (boolean) true / false
  • tetoSolar: (boolean) true / false
  • conversivel: (boolean) true / false
  • pilotoAutomatico: (boolean) true / false
  • sensorChuva: (boolean) true / false
  • blindado: (boolean) true / false
  • observacoes: (varchar) observações e anotações
  • renavam: (int) número do renavam
  • chassi: (varchar) número do chassi
  • esconderPreco: (boolean) true / false
  • textoAlternativoPreco: (varchar) texto para ser mostrado ao invés do preço
  • album: (array) com links para imagens

Exemplos:


    curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d

    {   
        "idMarca": 70,
        "idModelo": 1106,
        "preco": "3,500,000.00",
        "anoFabricacao": 1999,
        "anoModelo": 2000,
        "album": [
    "https://files.porsche.com/filestore/image/multimedia/none/f479e140-4f65-4655-a344-11747ad652a2/normal/bfad2dca-8d79-11eb-80d4-005056bbdc38;sJ;twebp/porsche-normal.webp",
    "https://files.porsche.com/filestore/galleryimagerwd/multimedia/none/992-gt3-gallery-03/zoom2/59ea44db-4450-11eb-80d1-005056bbdc38;sH;twebp/porsche-zoom2.webp",
    "https://files.porsche.com/filestore/galleryimagerwd/multimedia/none/992-gt3-gallery-04/zoom2/2aab4506-8d72-11eb-80d4-005056bbdc38;sH;twebp/porsche-zoom2.webp"
        ]
    }

    https://api.autobusiness.com.br/api/v1/veiculos/13970
            
        

    201 Created
    Content-Type: application/json
    {
        "Mensagem": "Veiculo editado com sucesso",
        "idVeiculo": 13970
    }
            
        

    401 Unauthorized
    Content-Type: application/json
    {
        "message": "Falha ao autenticar"
    }

5 - Excluir veículo anteriormente cadastrado

Requisição

DELETE https://api.autobusiness.com.br/api/v1/veiculos/{id}
Autenticação: Token Bearer

Parâmetros

Id do veículo no final da URL do Endpoint via DELETE

Exemplos:


        200 OK
        Content-Type: application/json
        [
            {
                "Mensagem": "Veiculo excluído com sucesso"
            }
        ]
    
        https://api.autobusiness.com.br/api/v1/veiculos/13969
                
            

        401 Unauthorized
        Content-Type: application/json
        {
            "message": "Falha ao autenticar"
        }