Conseils de pro sur la collecte de données brutes via Postman

Cas d'utilisation : Flux de données vers d'autres applications

Découvrez comment notre API facilite l'un des scénarios commerciaux les plus courants chez nos clients : le téléchargement de données brutes en vue de leur intégration dans des applications d'IA, des outils de BI et d'autres services. Ce processus permet la construction de vastes ensembles de Big Data, permettant une analyse complète des données et des analyses commerciales, en particulier dans le domaine de l'utilisation des transports. Les clients exploitent ces données pour rationaliser les coûts d'entretien des véhicules et améliorer les offres de services, en particulier dans les opérations de livraison et de service sur le terrain. Un exemple est la création de cartes thermiques pour visualiser les concentrations d'activité dans des zones spécifiques, qu'il s'agisse de la répartition des charges, des employés ou des véhicules.

Prenons l'exemple d'un client qui, après avoir constaté que la majorité de ses camions de livraison étaient concentrés dans une région particulière, a considérablement renforcé la visibilité de sa marque, élargi sa portée opérationnelle et augmenté ses ventes dans cette zone. Cette démarche stratégique implique la réaffectation de ressources provenant de zones moins actives, l'ouverture de nouveaux points de stockage et de distribution et l'affinement de l'approche marketing. En conséquence, ils ont obtenu une augmentation notable des taux de conversion en ajustant leurs dépenses publicitaires - en les augmentant dans les zones ciblées et en les réduisant dans les régions où l'intérêt est moindre. Ce résultat remarquable a été obtenu en quelques mois seulement.

Voyons plus en détail comment vous pouvez demander ces données pour vos applications, permettant ainsi l'acquisition automatique d'informations critiques. L'utilisation de ces données peut considérablement accroître la rentabilité de votre entreprise ou celle de vos clients.

Demande d'un fichier d'exportation de données brutes avec Postman

Autorisation

Pour commencer, vous devez obtenir votre clé API d'utilisateur à partir de notre collection. Cela se fait par le biais de la requête API user/auth. Voici comment procéder :

Authentifiez votre utilisateur: utilisez la requête API user/auth en fournissant votre nom d'utilisateur et votre mot de passe. Reportez-vous à notre documentation et reproduisez l'exemple fourni pour plus de clarté.

Dans Postman, collez l'exemple dans la ligne de requête.

Entrez les détails de connexion: Passez à la section Corps et saisissez le nom d'utilisateur et le mot de passe de votre compte utilisateur.

Lors de l'envoi de cette demande, la plateforme répondra avec un hachage de session. Cependant, ce hachage de session expire après 30 jours sans être renouvelé. Par conséquent, nous vous recommandons de créer une clé API pour votre collection.

Créez une clé API: Si vous ne l'avez pas encore fait, créez une clé API en exécutant la requête api/key/create API. Utilisez le hachage de session que vous avez obtenu précédemment et indiquez un titre pour la clé, tel que"pour les données brutes".

Création d'une nouvelle collection dans Postman

Dans Postman, commencez par créer une nouvelle collection, puis passez à l'onglet "Autorisation". Voici comment le configurer pour différents cas d'utilisation.

Pour une utilisation individuelle :

• Sélectionnez le type d'autorisation: Choisissez "API Key" dans le menu déroulant.
• Configurez la clé et la valeur:
• Clé: Saisissez "hash".
• Valeur: Saisissez ici votre clé API spécifique.
• Ajouter à: Choisissez "Query params". Postman inclura alors automatiquement votre clé API dans tous les appels API effectués à partir de cette collection.

Pour une utilisation en équipe :

Si la collection doit être utilisée au sein d'une équipe, il est préférable de définir des variables de collection pour une plus grande flexibilité.

• Sélectionnez le type d'autorisation: Choisissez "No Auth".
• Ajoutez une clé API aux variables de la collection:
• Accédez à la section "Variables" des paramètres de la collection.
• Créez une nouvelle variable (nommez-la de manière pertinente, par exemple "hash" ou "user1" si vous gérez plusieurs utilisateurs).
• Attribuez-lui n'importe quelle valeur initiale, mais assurez-vous que la "valeur actuelle" est définie sur la clé API que vous avez récemment obtenue.

N'oubliez pas d'enregistrer vos modifications après avoir configuré les variables.

Gestion de plusieurs utilisateurs :

Pour collaborer avec un autre utilisateur, il vous suffit d'ajouter une nouvelle variable pour sa clé API, par exemple en la nommant "user2".

Cette approche structurée garantit une gestion sûre et efficace des clés API dans Postman, tant pour les projets individuels que pour les collaborations au sein d'une équipe.

Demander un fichier de données brutes

Pour exporter un fichier de données brutes à partir de notre plateforme, assurez-vous de fournir les informations essentielles suivantes :

• **tracker_id**: L'identifiant unique de votre appareil enregistré sur la plateforme.
• **depuis**: L'heure de début de la période d'exportation des données.
• **to**: L'heure de fin de la période d'exportation des données : L'heure de fin des données que vous souhaitez récupérer de votre appareil.
• **Colonnes**: Spécifiez les types d'informations que vous souhaitez inclure dans votre fichier (par exemple, l'emplacement, la vitesse, la température).

Obtention de l'ID du traceur

Pour récupérer les identifiants de vos traceurs à l'aide de l'appel API tracker/list, procédez comme suit :

Commencez par ajouter une nouvelle requête: Dans Postman, créez une nouvelle collection si vous ne l'avez pas déjà fait, et ajoutez votre première requête à cette collection afin d'obtenir les identifiants des traceurs.

Configurez la requête: Copiez la configuration de notre exemple de requête. Les paramètres seront automatiquement ajoutés aux paramètres de la requête ou au corps de la requête, selon que l'exemple est une requête GET ou une commande cURL.

Envoyez la requête et analysez la réponse: Après avoir envoyé la requête, vous recevrez une réponse contenant une liste d'objets de suivi. Concentrez-vous sur le champ id de chaque objet, car il s'agit de votre tracker_id.

{ &nbsp ; &nbsp ; "list" : [ &nbsp ; &nbsp ; &nbsp ; &nbsp ; { &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; "id" : 642546, &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; "label" : "Tracker1", &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; "group_id" : 152722, &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; "source" : { &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; "id" : 416083, &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; "device_id" : "100000000002024", &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; "model" : "telfmb920", &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; "bloqué" : false, &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; "tariff_id" : 12163, &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; "phone" : "+442071234567", &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; "status_listing_id" : 80098, &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; "creation_date" : "2020-05-07", &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; "tariff_end_date" : "2024-03-01" &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; }, &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; "tag_bindings" : [], &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; "clone" : false &nbsp ; &nbsp ; &nbsp ; &nbsp ; }] }

Obtenir tous les paramètres pris en charge par un tracker

Pour découvrir les paramètres pris en charge par votre traceur, suivez les étapes suivantes pour ajouter un nouvel appel API :

Configurez l'appel API : Utilisez l'appel API tracker/raw_data/get_inputs . Dans le corps de la requête, assurez-vous d'inclure à la fois votre hash et le tracker_id que vous avez obtenu plus tôt.

Analysez la réponse : Après avoir envoyé la requête, la plateforme vous renverra une liste de paramètres disponibles pour le tracker. Ces paramètres peuvent inclure divers points de données, tels que l'emplacement, la vitesse, la température, etc., et la disponibilité de ces paramètres peut varier en fonction du modèle de traceur.

Répétez l'opération pour différents modèles : Si vous travaillez avec plusieurs modèles de traceurs, il est recommandé d'effectuer l'appel get_inputs pour chaque modèle afin d'identifier avec précision les paramètres pris en charge pour chacun d'entre eux.

{ &nbsp ; &nbsp ; "discrete_inputs" : 2, &nbsp ; &nbsp ; "discrete_outputs"


: 1, &nbsp ; &nbsp ; "inputs" : [ &nbsp ; &nbsp ; &nbsp ; "analog_1", &nbsp ; &nbsp ; &nbsp ; "avl_io_100000", &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; "axis_x", &nbsp ; &nbsp ; &nbsp ; "axis_y", &nbsp ; &nbsp ; &nbsp ; &nbsp ; "axis_z", &nbsp ; &nbsp ; &nbsp ; &nbsp ; "battery_current", &nbsp ; &nbsp ; &nbsp ; "battery_voltage", &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; "ble_battery_level_4", &nbsp ; &nbsp ; &nbsp ; "ble_battery_voltage_4", &nbsp ; &nbsp ; &nbsp ; &nbsp ; "ble_frequency_4", &nbsp ; &nbsp ; &nbsp ; &nbsp ; "ble_humidity_4", &nbsp ; &nbsp ; &nbsp ; &nbsp ; "ble_lls_level_4", &nbsp ; nbsp ; &nbsp ; &nbsp ; "ble_lls_temperature_4", &nbsp ; &nbsp ; &nbsp ; &nbsp ; "ble_luminosity_4", &nbsp ; &nbsp ; &nbsp ; &nbspnbsp ; &nbsp ; "ble_pitch_4", &nbsp ; &nbsp ; &nbsp ; "ble_roll_4", &nbsp ; &nbsp ; &nbsp ; &nbsp ; "ble_temp_sensor_4", &nbsp ; &nbsp ; &nbsp ; &nbsp ; "board_voltage", &nbsp ; &nbsp ; &nbsp ; "ext_temp_sensor_4", &nbsp ; &nbsp ; &nbsp ; &nbsp ; "hw_mileage", &nbsp ; &nbsp ; &nbsp ; "impulse_counter_1", &nbsp ; &nbsp ; &nbsp ; &nbsp ; "obd_absolute_load_value", &nbsp ; &nbsp ; &nbsp ; &nbsp ; "obd_barometric_pressure", &nbsp ; &nbsp ; &nbsp ; &nbsp ; "obd_consumption", &nbsp ; &nbsp ; &nbsp ; &nbsp ; "obd_control_module_voltage", &nbsp ; &nbsp ; &nbsp ; &nbsp ; "obd_coolant_t", &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; "obd_custom_fuel_litres", &nbsp ; &nbsp ; &nbsp ; &nbsp ; "obd_custom_odometer", &nbsp ; &nbsp ; &nbsp ; &nbsp ; "obd_engine_load", &nbsp ; &nbsp ; &nbsp ; "obd_fuel", &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; "obd_intake_air_t", &nbsp ; &nbsp ; &nbsp ; "obd_mil_run_time", &nbsp ; &nbsp ; &nbsp ; &nbsp ; "obd_oil_temperature", &nbsp ; &nbsp ; &nbsp ; &nbsp ; "obd_rpm", &nbsp ; &nbsp ; &nbsp ; "obd_speed", &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; "obd_throttle", &nbsp ; &nbsp ; &nbsp ; "obd_time_since_engine_start" &nbsp ; &nbsp ; ], &nbsp ; &nbsp ; "states" : [ &nbsp ; &nbsp ; &nbsp ; "ble_magnet_sensor_4", &nbsp ; &nbsp ; &nbsp ; "event_code", &nbsp ; &nbsp ; &nbsp ; &nbsp ; &nbsp ; "hardware_key", &nbsp ; &nbsp ; &nbsp ; "obd_dtc_cleared_distance", &nbsp ; &nbsp ; &nbsp ; &nbsp ; "obd_dtc_codes", &nbsp ; &nbsp ; &nbsp ; &nbsp ; "obd_dtc_number", &nbsp ; &nbsp ; &nbsp ; &nbsp ; "obd_mil_activated_distance", &nbsp ; &nbsp ; &nbsp ; &nbsp ; "obd_mil_status", &nbsp ; &nbsp ; &nbsp ; &nbsp ; "obd_vin" &nbsp ; &nbsp ; ], &nbsp ; &nbsp ; "success" : true }

Demander un fichier

Notre objectif est de compiler des données comprenant l'heure du serveur, les coordonnées géographiques (latitude, longitude), la vitesse de déplacement, les connexions satellites et divers autres détails tels que les relevés des capteurs de carburant analogiques, les états des entrées/sorties discrètes et les informations clés sur le matériel.

Paramètres simples et complexes :

• Paramètres simples : L'heure du serveur, la latitude (lat), la longitude (lng), la vitesse et les données satellitaires sont des paramètres simples accessibles à tous les traceurs. Vous pouvez les trouver dans la documentation de l'API.
• Paramètres complexes : Pour accéder aux valeurs de points de données plus complexes, utilisez un point (.) pour accéder à la valeur interne d'une colonne complexe.

Spécification de paramètres pour notre objet Columns :

• server_time: Indispensable pour horodater la réception des données par la plateforme.
• lat et lng: Pour déterminer l'emplacement.
• speed: Pour capturer la vitesse du mouvement.
• satellites: Pour le nombre de satellites en connexion.
• discrete_inputs.* : Pour collecter les informations d'état de toutes les entrées.
• discrete_outputs.1: Si l'appareil dispose d'une seule sortie discrète, nous l'indiquons par "1". Un astérisque (*) peut également être utilisé pour la généralisation.

Mise en œuvre de l'appel API :

• Copiez l'exemple fourni pour l'appel API tracker/raw_data/read dans Postman.
• Saisissez tous les paramètres nécessaires comme indiqué.

Spécification du fuseau horaire :

• Les paramètres from et to permettent d'ajuster le fuseau horaire, bien que notre exemple prenne par défaut la valeur UTC+0.

Une fois votre demande traitée avec succès, la plateforme vous répondra avec les données au format CSV. Ce format est largement supporté et peut être facilement intégré dans votre programme pour une analyse, une manipulation ou une visualisation plus poussée. Assurez-vous que votre application est prête à analyser les fichiers CSV pour tirer le meilleur parti des données fournies.

"msg_time", "server_time", "lat", "lng", "speed", "satellites", "discrete_inputs.2", "discrete_outputs.1"
"2024-02-08T02:00:00-0600","2024-02-08T02:00:03-0600",13.73135,-89.3933483,0,20,0,0
"2024-02-08T02:05:01-0600","2024-02-08T02:05:03-0600",13.73135,-89.3933483,0,21,0,0
"2024-02-08T02:10:01-0600","2024-02-08T02:10:04-0600",13.73135,-89.3933483,0,21,0,0
"2024-02-08T02:15:02-0600","2024-02-08T02:15:04-0600",13.73135,-89.3933483,0,21,0,0
"2024-02-08T02:20:02-0600","2024-02-08T02:20:04-0600",13.73135,-89.3933483,0,20,0,0
"2024-02-08T02:25:03-0600","2024-02-08T02:25:09-0600",13.73135,-89.3933483,0,22,0,0
"2024-02-08T02:30:03-0600","2024-02-08T02:30:06-0600",13.73135,-89.3933483,0,22,0,0
"2024-02-08T02:35:04-0600","2024-02-08T02:35:07-0600",13.73135,-89.3933483,0,21,0,0
"2024-02-08T02:40:04-0600","2024-02-08T02:40:07-0600",13.73135,-89.3933483,0,21,0,0
"2024-02-08T02:45:04-0600","2024-02-08T02:45:07-0600",13.73135,-89.3933483,0,22,0,0
"2024-02-08T02:50:05-0600","2024-02-08T02:50:09-0600",13.73135,-89.3933483,0,22,0,0
"2024-02-08T02:55:05-0600","2024-02-08T02:55:08-0600",13.73135,-89.3933483,0,21,0,0

L'avenir de l'entreprise grâce à l'analyse avancée des données

L'avènement d'API et d'outils d'analyse de données avancés annonce une nouvelle ère pour les entreprises qui cherchent à optimiser leurs opérations et à améliorer leur prise de décision. En exploitant la puissance de la collecte et de l'analyse des données en temps réel et l'utilisation stratégique de ces informations, les entreprises peuvent atteindre des niveaux d'efficacité, de satisfaction de la clientèle et de rentabilité sans précédent. Comme nous l'avons démontré, l'application pratique de ces technologies dans des domaines tels que la gestion des données des traceurs simplifie non seulement des processus complexes, mais ouvre également la voie à l'innovation et à la croissance. La clé du succès réside dans l'intégration efficace de ces outils dans les modèles d'entreprise, associée à une recherche continue d'amélioration et d'adaptation aux tendances émergentes. Ce faisant, les entreprises se positionnent à l'avant-garde de leur secteur, prêtes à relever les défis de l'avenir avec confiance et agilité.