Flux de travail
L'objectif de l'API Emission Insight est de calculer les émissions d'une activité d'un véhicule ou d'une machine. L'activité d'un véhicule peut consister à rouler uniquement, à travailler uniquement ou les deux.
En outre, il peut s'agir d'un calcul préliminaire ou complet. Un calcul préliminaire est un calcul dont les données sont manquantes. Par exemple, il peut s'agir d'une prédiction ou d'un pré-calcul d'activités ou de données manquantes concernant la machine ou son (ses) moteur(s).
Lorsque des informations sont manquantes, il peut être souhaitable d'effectuer un nouveau calcul ultérieurement. Lorsque les informations manquantes sont ajoutées, un nouveau calcul peut être effectué avec les informations ajoutées et l'état du calcul devient complet.
Un exemple de calcul complet est une activité pour laquelle les données d'activité réelles et toutes les informations techniques du véhicule sont connues.
Données requises
Les informations requises pour que le modèle de calcul des perspectives d'émission puisse effectuer un calcul sont basées sur les informations dont dispose chaque entreprise ou système de planification.
Toutefois, si les données relatives aux véhicules ou aux machines sont incomplètes, nous pouvons tout de même effectuer des calculs. Cela nous oblige à faire des hypothèses, ce qui affecte la précision du calcul. C'est pourquoi Emission Insight a développé son algorithme de précision Emission Insight (EIAA).
Un score de précision est déterminé sur la base des hypothèses, qui est renvoyé avec le calcul pour chaque émission individuelle. Le score détermine l'écart possible par rapport à l'émission réelle ; plus le score est faible, plus l'écart peut être important. Sur la base du score, vous pouvez décider de ce qu'il convient de faire avec les données de sortie. Si nécessaire, vous pouvez effectuer un nouveau calcul à un moment ultérieur, lorsque vous disposerez de toutes les données.
Authentification
Vous avez besoin d'une clé d'abonnement pour accéder à l'API. Après avoir créé un compte sur le portail des développeurs d'Emission Insight, vous trouverez vos clés dans les détails de l'abonnement à votre produit. Il est important de garder votre clé confidentielle. Vous ne devez pas la placer dans un code distribué publiquement.
Versions de l'API
La version actuelle de l'API Emission Insight est v1, ce qui signifie que tous les chemins de requête commencent par /v1/.
Gestion des erreurs
Les erreurs sont signalées par des codes d'état HTTP standard. Il est important de s'assurer que votre application traite les erreurs de manière appropriée. À cette fin, veuillez consulter la liste des codes d'état attendus qui est fournie avec la documentation de chaque point d'accès.
Des précautions particulières doivent être prises pour assurer une manipulation correcte des :
- HTTP 429 : trop de demandes. Si vous rencontrez des erreurs 429 et que vous souhaitez augmenter votre vitesse de traduction, veuillez contacter [email protected].
- HTTP 456 : quota dépassé.
- HTTP 422 : Entité non traitable. Il manque des informations obligatoires dans votre saisie ou l'un des champs ne figure pas parmi les options proposées.
Des informations supplémentaires peuvent être fournies par une réponse JSON qui contient plus de détails sur l'erreur. Dans ce cas, ces informations supplémentaires seront contenues dans la clé "message".