Consultar corrida
curl --request GET \
--url https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/{id} \
--header 'Authorization: Basic <encoded-value>' \
--header 'api-key: <api-key>'import requests
url = "https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/{id}"
headers = {
"Authorization": "Basic <encoded-value>",
"api-key": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {Authorization: 'Basic <encoded-value>', 'api-key': '<api-key>'}
};
fetch('https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/{id}")
.header("Authorization", "Basic <encoded-value>")
.header("api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"response": {
"id": "100018001",
"data_hora_solicitacao": "2024-05-02 08:53:42",
"data_hora_solicitacao_utc": "2024-05-02T11:53:42Z",
"data_hora_chegada_local": null,
"data_hora_chegada_local_utc": null,
"status_solicitacao": "N",
"cliente_id": "83605",
"nome_passageiro": "Rogério Barreto",
"empresa_id": null,
"bandeira_chamada_id": "8",
"data_hora_aceite": null,
"data_hora_aceite_utc": null,
"data_hora_finalizacao": null,
"data_hora_finalizacao_utc": null,
"data_hora_cancelamento": null,
"data_hora_cancelamento_utc": null,
"data_hora_pendencia": "2024-05-02 08:53:49",
"data_hora_pendencia_utc": "2024-05-02T11:53:49Z",
"distancia_coleta_km": null,
"valor_corrida": "7.00",
"valor_corrida_integral": "10.00",
"condutor_especificado": false,
"com_retorno": false,
"condutor_id": "",
"nome_condutor": "",
"telefone_condutor": "",
"veiculo": "",
"placa_veiculo": "",
"cor_veiculo": null,
"duracao_corrida": "0",
"distancia_percorrida_km": "0",
"data_hora_inicio": null,
"tipo_pagamento": "D",
"desconto": "0.00",
"tarifa": "Tarifa padrão",
"id_categoria": "71",
"categoria": "Comum",
"descricao_categoria": "Viagens curtas-médias",
"nome_cliente": "Rogério Barreto",
"cpf_cliente": "111.222.333-44",
"taxas_cancelamento": null,
"partida": {
"endereco": "Rua Altaneira",
"complemento": null,
"referencia": null,
"bairro": "Campo Grande",
"cidade": "Rio de Janeiro",
"estado": "RJ",
"lat": "-22.8743056",
"lng": "-43.5626744"
},
"desejado": null,
"paradas": [
{
"id": "358",
"endereco": "Praia do Arpoador",
"complemento": "",
"bairro": "Arpoador",
"cidade": "Rio de Janeiro",
"uf": "RJ",
"lat": "-22.988420900610592",
"lng": "-43.1934916318077",
"ordem": 0,
"numero_pedido": "2"
}
],
"link_acompanhamento_solicitacao": "https://link-acompanhamento-exemplo/solicitacao/acompanhar/OTU2MzE0ODIyOTM1MQ=="
}
}Corridas
Consultar corrida
Consulta uma corrida específica pelo identificador interno da corrida.
O campo valor_corrida traz o valor já líquido, com o desconto do cupom aplicado, e valor_corrida_integral traz o valor bruto da corrida, antes do desconto. Sem cupom aplicado, os dois campos são iguais.
O bloco desejado traz o endereço de destino (endereco, bairro, cidade, estado, lat e lng) e vem null quando a corrida não tem destino definido.
Os campos de data e hora data_hora_solicitacao, data_hora_chegada_local, data_hora_aceite, data_hora_finalizacao, data_hora_cancelamento e data_hora_pendencia continuam no horário da central e no formato AAAA-MM-DD HH:MM:SS. Cada um deles ganhou uma cópia com o sufixo _utc (por exemplo, data_hora_aceite_utc), em ISO 8601 e em UTC (por exemplo, 2023-11-07T05:31:56Z), que vem null quando o original vem null.
Cada corrida traz também, na raiz, os dados de fechamento que antes só vinham no recibo, em qualquer status:
data_hora_inicio: início da corrida (nullenquanto não iniciou), em ISO 8601 e em UTC (por exemplo,2023-11-07T05:31:56Z);tipo_pagamento;desconto: percentual de desconto (0.00quando não há);tarifa,id_categoria,categoriaedescricao_categoria;nome_cliente;cpf_cliente: só quando a corrida não é corporativa (semempresa_id);cnpj_cpf_empresa: só quando a corrida é corporativa (comempresa_id);codigo_cupomegerador_cupom_id: só quando a corrida usou cupom.
GET
/
corridas
/
{id}
Consultar corrida
curl --request GET \
--url https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/{id} \
--header 'Authorization: Basic <encoded-value>' \
--header 'api-key: <api-key>'import requests
url = "https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/{id}"
headers = {
"Authorization": "Basic <encoded-value>",
"api-key": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {Authorization: 'Basic <encoded-value>', 'api-key': '<api-key>'}
};
fetch('https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/{id}")
.header("Authorization", "Basic <encoded-value>")
.header("api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-vendas.taximachine.com.br/api/v2/integracao/corridas/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"response": {
"id": "100018001",
"data_hora_solicitacao": "2024-05-02 08:53:42",
"data_hora_solicitacao_utc": "2024-05-02T11:53:42Z",
"data_hora_chegada_local": null,
"data_hora_chegada_local_utc": null,
"status_solicitacao": "N",
"cliente_id": "83605",
"nome_passageiro": "Rogério Barreto",
"empresa_id": null,
"bandeira_chamada_id": "8",
"data_hora_aceite": null,
"data_hora_aceite_utc": null,
"data_hora_finalizacao": null,
"data_hora_finalizacao_utc": null,
"data_hora_cancelamento": null,
"data_hora_cancelamento_utc": null,
"data_hora_pendencia": "2024-05-02 08:53:49",
"data_hora_pendencia_utc": "2024-05-02T11:53:49Z",
"distancia_coleta_km": null,
"valor_corrida": "7.00",
"valor_corrida_integral": "10.00",
"condutor_especificado": false,
"com_retorno": false,
"condutor_id": "",
"nome_condutor": "",
"telefone_condutor": "",
"veiculo": "",
"placa_veiculo": "",
"cor_veiculo": null,
"duracao_corrida": "0",
"distancia_percorrida_km": "0",
"data_hora_inicio": null,
"tipo_pagamento": "D",
"desconto": "0.00",
"tarifa": "Tarifa padrão",
"id_categoria": "71",
"categoria": "Comum",
"descricao_categoria": "Viagens curtas-médias",
"nome_cliente": "Rogério Barreto",
"cpf_cliente": "111.222.333-44",
"taxas_cancelamento": null,
"partida": {
"endereco": "Rua Altaneira",
"complemento": null,
"referencia": null,
"bairro": "Campo Grande",
"cidade": "Rio de Janeiro",
"estado": "RJ",
"lat": "-22.8743056",
"lng": "-43.5626744"
},
"desejado": null,
"paradas": [
{
"id": "358",
"endereco": "Praia do Arpoador",
"complemento": "",
"bairro": "Arpoador",
"cidade": "Rio de Janeiro",
"uf": "RJ",
"lat": "-22.988420900610592",
"lng": "-43.1934916318077",
"ordem": 0,
"numero_pedido": "2"
}
],
"link_acompanhamento_solicitacao": "https://link-acompanhamento-exemplo/solicitacao/acompanhar/OTU2MzE0ODIyOTM1MQ=="
}
}Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Obrigatório. Sua chave API.
Path Parameters
Identificador interno da corrida.
Response
200 - application/json
Sucesso
The response is of type object.