Ir al contenido principal

API Externa de RAM Tracking

Guía para comenzar con la API externa de RAM Tracking.

Actualizado hoy

Accede a tus datos de seguimiento de vehículos de forma programática con nuestra API externa. Perfecto para integrar los datos de RAM Tracking en tus propios sistemas, aplicaciones o paneles de control.

Primeros pasos

Lo que necesitarás:

  • Una cuenta RAM Tracking activa

  • Conocimientos básicos sobre APIs y solicitudes HTTP

  • Herramientas de desarrollo como Postman o el lenguaje de programación de tu elección

  • Documentación completa de la API: https://api.qaifn.co.uk/swagger/docs

Obtén tus credenciales API

  1. Inicia sesión en tu portal RAM Tracking

  2. Haz clic en el icono de perfil en la esquina superior derecha

  3. Selecciona « Obtener clave API » en el menú desplegable

  4. Haz clic en el botón « Obtener clave API » para generar tus credenciales

Recibirás:

  • Client ID

  • Client Secret

  • Usuario y contraseña de la API

Cómo usar la API

Paso 1: Obtén tu token de acceso – Envía una solicitud a nuestro endpoint de autenticación con tus credenciales: https://auth.qaifn.co.uk/oauth/token. Incluye tu usuario API, contraseña, client ID y secret.

Paso 2: Realiza solicitudes API – Usa tu token de acceso para solicitar datos de nuestros endpoints API: https://api.qaifn.co.uk/api/v1/vehicle/for-account. Incluye tu token como Bearer en el encabezado de Autorización.

Límites importantes

  • Límite de solicitudes: hasta 3 solicitudes por minuto por endpoint. Esto evita sobrecargar los servidores y garantiza un servicio confiable para todos los usuarios.

  • Sincronización de datos: los datos de los vehículos están disponibles en tiempo real para siempre obtener la información más actual.

Datos disponibles

Nuestra API proporciona acceso completo a los datos de seguimiento de vehículos, incluyendo:

  • Ubicaciones y rutas de vehículos

  • Velocidad y comportamiento de conducción

  • Historial de viajes

  • Información de conductores

  • Estado y diagnósticos de vehículos

Para la lista completa de endpoints y campos de datos disponibles, consulte nuestra documentación Swagger enlazada arriba.

Considere usar Webhooks

Antes de usar polling con la API, considere los webhooks. En lugar de solicitar datos repetidamente, los webhooks envían automáticamente información a tu sistema cuando ocurre un evento.

Beneficios de los webhooks

  • Entrega de datos en tiempo real

  • Sin límites de solicitudes

  • Más eficiente que el polling

  • Menor carga del servidor


Obtener ayuda

Importante: Nuestro equipo de soporte no puede brindar asistencia de desarrollo para la API externa. Sin embargo, hemos preparado una colección Postman para ayudarte a comenzar.

Simplemente copia el JSON a un archivo, impórtalo en Postman e ingresa tus credenciales para conectarte a la API externa.

 { "info": { "_postman_id": "a80d4065-e21a-41c1-8cba-d04727d1f569", "name": "External API Customer Example", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_exporter_id": "21728610" }, "item": [ { "name": "Get Token", "event": [ { "listen": "test", "script": { "exec": [ "var jsonData = pm.response.json();", "pm.environment.set("access_token", jsonData.access_token);" ], "type": "text/javascript" } } ], "request": { "auth": { "type": "basic", "basic": [ { "key": "password", "value": "{secret}", "type": "string" }, { "key": "username", "value": "{clientId}", "type": "string" } ] }, "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "grant_type", "value": "password", "type": "text" }, { "key": "username", "value": "{username}", "type": "text" }, { "key": "password", "value": "{password}", "type": "text" } ] }, "url": { "raw": "https://auth.qaifn.co.uk/oauth/token", "protocol": "https", "host": [ "auth", "qaifn", "co", "uk" ], "path": [ "oauth", "token" ] } }, "response": [] }, { "name": "GET All Vehicles for Account Copy", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "######{{access_token}}", "type": "string" } ] }, "method": "GET", "header": [], "url": { "raw": "https://api.qaifn.co.uk/api/v1/vehicle/for-account", "protocol": "https", "host": [ "api", "qaifn", "co", "uk" ], "path": [ "api", "v1", "vehicle", "for-account" ] } }, "response": [] } ]}

¿Aún tienes problemas para configurar la API?

¿Ha quedado contestada tu pregunta?