TrackMind API

curl https://api.trackmind.ru/vehicles \
  -H "Authorization: Bearer tm_ваш_ключ_здесь"

Authorization: Bearer tm_ваш_ключ_здесь

{
  "error": "Описание ошибки на русском"
}

GET https://api.trackmind.ru/vehicles
Authorization: Bearer tm_xxxxxxxxxxxxxxxx

{
  "vehicles": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Газель 001",
      "license_plate": "А123БВ77",
      "make": "ГАЗ",
      "model": "Газель Next",
      "driver_name": "Иванов Иван",
      "driver_phone": "+7 900 123-45-67",
      "speed_limit": 90,
      "fuel_consumption_base": 12.5,
      "marker_type": "van-large",
      "group_id": "uuid-группы",
      "group_name": "Доставка МСК",
      "group_color": "#4F8EF7",
      "device_imei": "123456789012345",
      "position": {
        "lat": 55.7558,
        "lon": 37.6173,
        "speed": 42,
        "heading": 270,
        "satellites": 12,
        "time": "2026-06-01T08:30:00.000Z",
        "ignition": true,
        "sensors": {
          "voltage": 12.4,
          "bat_pct": 87,
          "mileage": 142300,
          "fuel": 65,
          "gsm": 18
        }
      }
    }
  ]
}

GET https://api.trackmind.ru/vehicles/550e8400-e29b-41d4-a716-446655440000
Authorization: Bearer tm_xxxxxxxxxxxxxxxx

{
  "lat": 55.7558,
  "lon": 37.6173,
  "speed": 42,
  "heading": 270,
  "satellites": 12,
  "time": "2026-06-01T08:30:00.000Z",
  "ignition": true,
  "sensors": {
    "voltage": 12.4,
    "bat_pct": 87,
    "mileage": 142300
  }
}

GET https://api.trackmind.ru/vehicles/550e8400.../track
  ?from=2026-06-01T00:00:00Z
  &to=2026-06-01T23:59:59Z
  &min_stop=5
Authorization: Bearer tm_xxxxxxxxxxxxxxxx

{
  "points": [
    {
      "lat": 55.7558,
      "lon": 37.6173,
      "speed": 0,
      "heading": 0,
      "time": "2026-06-01T06:00:00.000Z",
      "gps_status": "valid"
    },
    { "lat": 55.7612, "lon": 37.6254, "speed": 54, "heading": 90, "time": "2026-06-01T06:02:00.000Z", "gps_status": "valid" }
  ],
  "stops": [
    {
      "lat": 55.7558,
      "lon": 37.6173,
      "start": "2026-06-01T06:00:00.000Z",
      "end":   "2026-06-01T06:15:00.000Z",
      "duration_minutes": 15
    }
  ],
  "stats": {
    "distance_km": 142.3,
    "moving_minutes": 198,
    "stop_minutes": 42,
    "max_speed": 112,
    "avg_speed": 73,
    "interpolated_distance_km": 0
  },
  "interpolated_segments": []
}

[
  {
    "id": "uuid-геозоны",
    "name": "Склад Москва",
    "type": "circle",
    "color": "#22C55E",
    "center_lat": 55.7558,
    "center_lon": 37.6173,
    "radius_m": 500,
    "points": null,
    "is_active": true,
    "notify_enter": true,
    "notify_exit": true,
    "vehicle_ids": ["uuid-тс-1", "uuid-тс-2"],
    "group_ids": [],
    "created_at": "2025-05-15T10:00:00.000Z"
  }
]

[
  {
    "id": "event-uuid",
    "event_type": "enter",
    "lat": 55.7558,
    "lon": 37.6173,
    "occurred_at": "2026-06-01T09:15:00.000Z",
    "geofence_id": "uuid-геозоны",
    "geofence_name": "Склад Москва",
    "geofence_color": "#22C55E",
    "vehicle_id": "uuid-тс",
    "vehicle_name": "Газель 001",
    "license_plate": "А123БВ77"
  }
]

[
  {
    "id": "uuid-ключа",
    "name": "CRM Интеграция",
    "key_prefix": "tm_a1b2c3d4e5f6",
    "scope": "read",
    "last_used_at": "2026-06-01T10:00:00.000Z",
    "created_at": "2025-05-10T12:00:00.000Z"
  }
]

{
  "name": "CRM Интеграция",
  "scope": "read"
}

{
  "id": "uuid-ключа",
  "name": "CRM Интеграция",
  "key_prefix": "tm_a1b2c3d4e5f6",
  "scope": "read",
  "created_at": "2026-06-01T12:00:00.000Z",
  "key": "tm_a1b2c3d4e5f6...полный_ключ_48_символов"
}

{ "ok": true }

POST https://your-server.com/webhook
Content-Type: application/json
User-Agent: TrackMind-Webhook/1.0
X-TrackMind-Event: position
X-TrackMind-Signature: sha256=abc123...хеш_подписи

{
  "event": "position",
  "timestamp": "2026-06-01T08:30:00.000Z",
  "data": {
    "vehicleId": "uuid-тс",
    "vehicleName": "Газель 001",
    "lat": 55.7558,
    "lon": 37.6173,
    "speed": 42,
    "heading": 270,
    "satellites": 12,
    "time": "2026-06-01T08:30:00.000Z",
    "ignition": true,
    "sensors": {
      "voltage": 12.4,
      "bat_pct": 87,
      "mileage": 142300,
      "fuel": 65,
      "gsm": 18
    }
  }
}

import { createHmac } from 'crypto';

function verifyWebhook(body: string, signature: string, secret: string): boolean {
  const expected = 'sha256=' + createHmac('sha256', secret).update(body).digest('hex');
  // timingSafeEqual защищает от timing-атак
  const a = Buffer.from(expected);
  const b = Buffer.from(signature);
  if (a.length !== b.length) return false;
  return require('crypto').timingSafeEqual(a, b);
}

// В вашем обработчике Express/Fastify:
app.post('/webhook', (req, res) => {
  const rawBody = req.rawBody; // строка, не объект
  const sig = req.headers['x-trackmind-signature'] as string;
  if (!verifyWebhook(rawBody, sig, process.env.WEBHOOK_SECRET!)) {
    return res.status(401).send('Invalid signature');
  }
  // Обрабатываем событие
  const event = JSON.parse(rawBody);
  console.log('Событие:', event.event, event.data);
  res.send({ ok: true });
});

import hmac, hashlib

def verify_webhook(body: bytes, signature: str, secret: str) -> bool:
    expected = 'sha256=' + hmac.new(
        secret.encode(), body, hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(expected, signature)

# Flask:
from flask import request
@app.route('/webhook', methods=['POST'])
def webhook():
    sig = request.headers.get('X-TrackMind-Signature', '')
    if not verify_webhook(request.data, sig, WEBHOOK_SECRET):
        return 'Invalid signature', 401
    event = request.json
    print(f"Событие: {event['event']}")
    return {'ok': True}

{
  "webhooks": [
    {
      "id": "uuid-вебхука",
      "url": "https://your-server.com/webhook",
      "has_secret": true,
      "events": ["position", "geofence.enter", "geofence.exit"],
      "enabled": true,
      "last_triggered_at": "2026-06-01T10:00:00.000Z",
      "last_status": 200,
      "created_at": "2025-05-01T12:00:00.000Z"
    }
  ]
}

{
  "url": "https://your-server.com/webhook",
  "secret": "ваш-секретный-ключ-для-подписи",
  "events": ["position", "geofence.enter", "geofence.exit"]
}

{
  "enabled": false,
  "events": ["geofence.enter"]
}

{
  "ok": true,
  "status": 200
}
// При ошибке:
{
  "ok": false,
  "status": 0,
  "error": "timeout"
}

curl https://api.trackmind.ru/vehicles \
  -H "Authorization: Bearer tm_ваш_ключ"

curl "https://api.trackmind.ru/vehicles/UUID_ТС/track?from=2026-06-01T00:00:00Z&to=2026-06-01T23:59:59Z" \
  -H "Authorization: Bearer tm_ваш_ключ"

curl -X POST https://api.trackmind.ru/webhooks \
  -H "Authorization: Bearer tm_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://your-server.com/hook","events":["position","geofence.enter"]}'

const API_URL = 'https://api.trackmind.ru';
const API_KEY  = process.env.TRACKMIND_API_KEY;

const headers = {
  'Authorization': `Bearer ${API_KEY}`,
  'Content-Type': 'application/json',
};

// Получить все ТС
async function getVehicles() {
  const res = await fetch(`${API_URL}/vehicles`, { headers });
  if (!res.ok) throw new Error(`API error ${res.status}`);
  const { vehicles } = await res.json();
  return vehicles;
}

// Трек за период
async function getTrack(vehicleId: string, from: Date, to: Date) {
  const params = new URLSearchParams({
    from: from.toISOString(),
    to:   to.toISOString(),
    min_stop: '5',
  });
  const res = await fetch(`${API_URL}/vehicles/${vehicleId}/track?${params}`, { headers });
  if (!res.ok) throw new Error(`API error ${res.status}`);
  return res.json(); // { points, stops, stats }
}

// Использование
const vehicles = await getVehicles();
console.log('ТС:', vehicles.map(v => v.name));

const track = await getTrack(vehicles[0].id, new Date('2026-06-01'), new Date('2026-06-02'));
console.log('Пробег:', track.stats.distance_km, 'км');
console.log('Остановок:', track.stops.length);

import os, requests
from datetime import datetime, timezone

API_URL = 'https://api.trackmind.ru'
API_KEY = os.environ['TRACKMIND_API_KEY']

session = requests.Session()
session.headers.update({
    'Authorization': f'Bearer {API_KEY}',
    'Content-Type': 'application/json',
})

def get_vehicles():
    r = session.get(f'{API_URL}/vehicles')
    r.raise_for_status()
    return r.json()['vehicles']

def get_track(vehicle_id: str, from_dt: datetime, to_dt: datetime):
    r = session.get(f'{API_URL}/vehicles/{vehicle_id}/track', params={
        'from': from_dt.isoformat(),
        'to':   to_dt.isoformat(),
        'min_stop': 5,
    })
    r.raise_for_status()
    return r.json()  # {'points': [...], 'stops': [...], 'stats': {...}}

# Пример использования
vehicles = get_vehicles()
print('Транспортные средства:')
for v in vehicles:
    pos = v.get('position')
    status = f"{pos['lat']:.4f}, {pos['lon']:.4f} @ {pos['speed']} км/ч" if pos else 'нет данных'
    print(f"  {v['name']} ({v.get('license_plate', '-')}): {status}")

# Трек за вчера
from datetime import timedelta
to_dt   = datetime.now(timezone.utc).replace(hour=0, minute=0, second=0, microsecond=0)
from_dt = to_dt - timedelta(days=1)
track = get_track(vehicles[0]['id'], from_dt, to_dt)
stats = track['stats']
print(f"Пробег: {stats['distance_km']} км, остановок: {len(track['stops'])}")