Sincronizar con un ERP o CRM

Mantén tu ERP o CRM al día con tus vehículos y los eventos de alertas mediante lectura periódica de la API, con un script de ejemplo con cursor.

Esta guía sincroniza dos cosas con un sistema externo: el inventario de vehículos (cada cierto tiempo) y los eventos de alertas (de forma incremental). La API entrega los datos; el modelo de tu ERP o CRM y su lógica los defines tú.

Plan #

Inventario: llama a get_devices con limit y page hasta que la lista llegue vacía. Relaciona cada id con tu activo; los datos del equipo (IMEI, placa) están en device_data.
Eventos: llama a get_events sin page. La respuesta trae items.data y items.next_cursor; envía next_cursor como cursor hasta que sea null.
Incremental: en las ejecuciones siguientes usa date_from con la fecha del último evento que procesaste, para no recorrer todo. Las fechas se interpretan en la zona horaria de la cuenta.
Idempotencia: usa el id del evento como clave única en tu sistema. Si una ejecución se repite, no duplicarás registros.
Frecuencia: no hay una frecuencia oficial. Respeta los límites y reintenta con espera creciente si recibes un 429 o un 5xx.

Inventario de vehículos #

Listar vehículos

cURL

curl -sS -G "https://plataforma.trackerintl.com/api/get_devices" \
  -H "user-api-hash: TU_API_HASH" \
  --data-urlencode "limit=50" \
  --data-urlencode "page=1"

JavaScript · Node.js 22

JavaScript

const BASE_URL = "https://plataforma.trackerintl.com";
const API_HASH = "TU_API_HASH";

const params = new URLSearchParams({
  limit: "50",
  page: "1",
});
const respuesta = await fetch(`${BASE_URL}/api/get_devices?${params}`, {
  headers: { "user-api-hash": API_HASH },
});
if (!respuesta.ok) throw new Error(`HTTP ${respuesta.status}: ${await respuesta.text()}`);
console.log(JSON.stringify(await respuesta.json(), null, 2));

Python · Python 3 con requests

Python

import json
import requests

BASE_URL = "https://plataforma.trackerintl.com"
API_HASH = "TU_API_HASH"

respuesta = requests.get(
    f"{BASE_URL}/api/get_devices",
    headers={"user-api-hash": API_HASH},
    params={"limit": "50", "page": "1"},
    timeout=30,
)
respuesta.raise_for_status()
print(json.dumps(respuesta.json(), indent=2, ensure_ascii=False))

PHP · PHP 8 con cURL

PHP

<?php
$baseUrl = "https://plataforma.trackerintl.com";
$apiHash = "TU_API_HASH";

$url = $baseUrl . "/api/get_devices?" . http_build_query(["limit" => "50", "page" => "1"]);
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => ["user-api-hash: " . $apiHash],
]);
$cuerpo = curl_exec($ch);
$codigo = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($cuerpo === false || $codigo !== 200) {
    fwrite(STDERR, "HTTP $codigo\n");
    exit(1);
}
echo json_encode(json_decode($cuerpo, true), JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE), "\n";

Eventos con cursor #

Eventos recientes

cURL

curl -sS -G "https://plataforma.trackerintl.com/api/get_events" \
  -H "user-api-hash: TU_API_HASH" \
  --data-urlencode "limit=50"

JavaScript · Node.js 22

JavaScript

const BASE_URL = "https://plataforma.trackerintl.com";
const API_HASH = "TU_API_HASH";

const params = new URLSearchParams({
  limit: "50",
});
const respuesta = await fetch(`${BASE_URL}/api/get_events?${params}`, {
  headers: { "user-api-hash": API_HASH },
});
if (!respuesta.ok) throw new Error(`HTTP ${respuesta.status}: ${await respuesta.text()}`);
console.log(JSON.stringify(await respuesta.json(), null, 2));

Python · Python 3 con requests

Python

import json
import requests

BASE_URL = "https://plataforma.trackerintl.com"
API_HASH = "TU_API_HASH"

respuesta = requests.get(
    f"{BASE_URL}/api/get_events",
    headers={"user-api-hash": API_HASH},
    params={"limit": "50"},
    timeout=30,
)
respuesta.raise_for_status()
print(json.dumps(respuesta.json(), indent=2, ensure_ascii=False))

PHP · PHP 8 con cURL

PHP

<?php
$baseUrl = "https://plataforma.trackerintl.com";
$apiHash = "TU_API_HASH";

$url = $baseUrl . "/api/get_events?" . http_build_query(["limit" => "50"]);
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => ["user-api-hash: " . $apiHash],
]);
$cuerpo = curl_exec($ch);
$codigo = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($cuerpo === false || $codigo !== 200) {
    fwrite(STDERR, "HTTP $codigo\n");
    exit(1);
}
echo json_encode(json_decode($cuerpo, true), JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE), "\n";

Script de ejemplo #

Este script lee todos los eventos disponibles siguiendo el cursor y muestra cuántos leyó. Sustituye la parte final por la escritura en tu sistema.

Leer eventos con cursor

cURL

#!/usr/bin/env bash
# Requiere curl y jq.
BASE_URL="https://plataforma.trackerintl.com"
API_HASH="TU_API_HASH"

CURSOR=""
TOTAL=0

while true; do
  RESPUESTA=$(curl -sS -G "$BASE_URL/api/get_events" \
    -H "user-api-hash: $API_HASH" \
    --data-urlencode "limit=50" \
    --data-urlencode "cursor=$CURSOR")
  # Aquí guardas los eventos en tu sistema, usando .id como clave única.
  TOTAL=$((TOTAL + $(echo "$RESPUESTA" | jq '.items.data | length')))
  CURSOR=$(echo "$RESPUESTA" | jq -r '.items.next_cursor // empty')
  [ -z "$CURSOR" ] && break
done

echo "Eventos leídos: $TOTAL"

JavaScript · Node.js 22

JavaScript

const BASE_URL = "https://plataforma.trackerintl.com";
const API_HASH = "TU_API_HASH";

let cursor = null;
let total = 0;

do {
  const params = new URLSearchParams({ limit: "50" });
  if (cursor) params.set("cursor", cursor);

  const respuesta = await fetch(`${BASE_URL}/api/get_events?${params}`, {
    headers: { "user-api-hash": API_HASH },
  });
  if (!respuesta.ok) throw new Error(`HTTP ${respuesta.status}`);
  const { items } = await respuesta.json();

  for (const evento of items.data) {
    // Aquí guardas el evento en tu sistema, usando evento.id como clave única.
    total += 1;
  }
  cursor = items.next_cursor;
} while (cursor);

console.log(`Eventos leídos: ${total}`);

Python · Python 3 con requests

Python

import requests

BASE_URL = "https://plataforma.trackerintl.com"
API_HASH = "TU_API_HASH"

cursor = None
total = 0

while True:
    params = {"limit": "50"}
    if cursor:
        params["cursor"] = cursor
    respuesta = requests.get(
        f"{BASE_URL}/api/get_events",
        headers={"user-api-hash": API_HASH},
        params=params,
        timeout=30,
    )
    respuesta.raise_for_status()
    items = respuesta.json()["items"]

    for evento in items["data"]:
        # Aquí guardas el evento en tu sistema, usando evento["id"] como clave única.
        total += 1

    cursor = items["next_cursor"]
    if not cursor:
        break

print(f"Eventos leídos: {total}")

PHP · PHP 8 con cURL

PHP

<?php
$baseUrl = "https://plataforma.trackerintl.com";
$apiHash = "TU_API_HASH";

$cursor = null;
$total = 0;

do {
    $params = ["limit" => "50"];
    if ($cursor) {
        $params["cursor"] = $cursor;
    }
    $ch = curl_init($baseUrl . "/api/get_events?" . http_build_query($params));
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 30,
        CURLOPT_HTTPHEADER => ["user-api-hash: " . $apiHash],
    ]);
    $cuerpo = curl_exec($ch);
    $codigo = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
    if ($cuerpo === false || $codigo !== 200) {
        fwrite(STDERR, "HTTP $codigo\n");
        exit(1);
    }
    $items = json_decode($cuerpo, true)["items"];

    foreach ($items["data"] as $evento) {
        // Aquí guardas el evento en tu sistema, usando $evento["id"] como clave única.
        $total++;
    }
    $cursor = $items["next_cursor"];
} while ($cursor);

echo "Eventos leídos: $total\n";

Plan #

Inventario de vehículos #

Eventos con cursor #

Script de ejemplo #

Relacionados