Siga-nos nas redes sociais:

Documentação da API

Integre nossa plataforma com seus sistemas de forma rápida e segura.

Autenticação

Nossa API utiliza autenticação via Bearer Token. Para obter seu token de acesso, entre em contato com nossa equipe de suporte. 

curl -X GET https://api.rastreamos.com.br/v1/veiculos \
  -H "Authorization: Bearer seu_token_aqui"

Mantenha seu token em segurança e nunca compartilhe com terceiros.

Endpoints

Listar Veículos

{
  "method": "GET",
  "path": "/v1/veiculos",
  "description": "Retorna lista de veículos",
  "parameters": {
    "page": "Número da página (opcional)",
    "limit": "Itens por página (opcional)"
  }
}

Exemplo de resposta: 

{
  "data": [
    {
      "id": "123",
      "placa": "ABC1234",
      "modelo": "Volvo FH",
      "status": "ativo"
    }
  ],
  "meta": {
    "total": 100,
    "page": 1,
    "limit": 10
  }
}

Obter Posição

{
  "method": "GET",
  "path": "/v1/veiculos/{id}/posicao",
  "description": "Retorna posição atual do veículo",
  "parameters": {
    "id": "ID do veículo"
  }
}

Exemplo de resposta: 

{
  "data": {
    "latitude": -23.550520,
    "longitude": -46.633308,
    "velocidade": 60,
    "timestamp": "2024-03-02T10:30:00Z"
  }
}

Códigos de Erro

Código Descrição
400 Requisição inválida
401 Não autorizado
404 Recurso não encontrado
429 Limite de requisições excedido
500 Erro interno do servidor

SDKs

PHP

veiculos->listar();

// Obter posição
$posicao = $client->veiculos->posicao('123');

Node.js

const Rastreamos = require('rastreamos');

const client = new Rastreamos('seu_token_aqui');

// Listar veículos
const veiculos = await client.veiculos.listar();

// Obter posição
const posicao = await client.veiculos.posicao('123');

Python

from rastreamos import Client

client = Client('seu_token_aqui')

# Listar veículos
veiculos = client.veiculos.listar()

# Obter posição
posicao = client.veiculos.posicao('123')