Accédez à vos données de suivi de véhicules de manière programmatique avec notre API externe. Parfait pour intégrer les données RAM Tracking dans vos propres systèmes, applications ou tableaux de bord.
Pour commencer
Ce dont vous aurez besoin :
Un compte RAM Tracking actif
Connaissances de base sur les API et les requêtes HTTP
Outils de développement comme Postman ou le langage de programmation de votre choix
Documentation complète de l’API : https://api.qaifn.co.uk/swagger/docs
Obtenez vos identifiants API
Connectez-vous à votre portail RAM Tracking
Cliquez sur l’icône de profil en haut à droite
Sélectionnez « Obtenir une clé API » dans le menu déroulant
Cliquez sur le bouton « Obtenir une clé API » pour générer vos identifiants
Vous recevrez :
Client ID
Client Secret
Nom d’utilisateur et mot de passe API
Comment utiliser l’API
Étape 1 : Obtenez votre token d’accès – Envoyez une requête à notre endpoint d’authentification avec vos identifiants : https://auth.qaifn.co.uk/oauth/token. Incluez votre nom d’utilisateur API, mot de passe, client ID et secret.
Étape 2 : Effectuez des requêtes API – Utilisez votre token d’accès pour demander des données à nos endpoints API : https://api.qaifn.co.uk/api/v1/vehicle/for-account. Incluez votre token comme Bearer dans l’en-tête Authorisation.
Limites importantes
Limitation de requêtes : jusqu’à 3 requêtes par minute pour chaque endpoint. Cela empêche la surcharge des serveurs et garantit un service fiable pour tous les utilisateurs.
Synchronisation des données : les données véhicules sont disponibles en temps réel pour toujours obtenir les informations les plus récentes.
Données disponibles
Notre API fournit un accès complet aux données de suivi des véhicules, notamment :
Localisations et itinéraires des véhicules
Vitesse et comportement de conduite
Historique des trajets
Informations sur les conducteurs
État et diagnostics des véhicules
Pour la liste complète des endpoints et champs de données disponibles, consultez notre documentation Swagger mentionnée ci-dessus.
Envisagez plutôt les Webhooks
Avant de lancer du polling API, pensez à utiliser les webhooks. Au lieu de demander continuellement de nouvelles données, les webhooks envoient automatiquement les informations à votre système lorsqu’un événement se produit.
Avantages des webhooks
Livraison des données en temps réel
Pas de limites de requêtes
Plus efficace que le polling
Moins de charge sur le serveur
Obtenir de l’aide
Important : Notre équipe de support ne peut pas fournir d’assistance au développement pour l’API externe. Cependant, nous avons préparé une collection Postman pour vous aider à démarrer.
Copiez simplement le JSON ci-dessous dans un fichier, puis importez-le dans Postman et entrez vos identifiants pour vous connecter à l’API externe.
{ "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": [] } ]}