06151-14 19 0 info@datron.de

Comment utiliser l’API par vous-même

Remarques préliminaires

  • Une fois l’application DATRON live installée, vous disposez d’un accès direct à l’API de votre machine DATRON (« Application Programming Interface », Interface de Programmation d’Application).
  • Il s’agit d’une REST API basée sur les protocoles http.

 

 

1. Désactiver HTTPS au niveau du contrôleur next

 

  • Afin de pouvoir communiquer avec l’API, le certificat SSL doit d’abord être désactivé dans la commande NEXT de la machine.
  • Pour cela allez dans Paramètres –> Paramètres utilisateur –> DATRON next Live (App) dans le contrôleur Next.
  • Si vous faites ensuite défiler la page vers le bas, vous pouvez cliquer sur la commande (marqué en bleu dans l’image) pour que le certificat SSL ne soit pas utilisé.

 

 

2. Accéder à la documentation de l’API

 

  • Une fois l’API activé ainsi que votre compte utilisateur dans le contrôle Next, vous pouvez accéder à l’API et à sa documentation.
  • Toutes les commandes sont répertoriées dans la documentation de l’API
  • Vous pouvez accéder à la documentation en ajoutant l’extension « /apiviewer » derrière l’adresse IP existante (de votre machine) dans le navigateur.
  • Exemple: http://80.000.08.88/apiviewer
  • IMPORTANT: A cette étape vous devez toujours utiliser Http et non Https dans l’URL.

 

3. Generate authentication tokens

 

  • Sur la page documentation dans la cathégorie USER, vous trouverez une commande POST : /Créer un jeton d’authentification (creat token).
  • Si vous cliquez sur « Try Out », un champ s’ouvre dans lequel vous pouvez entrer vos données d’utilisateur.
  • Cliquez ensuite sur le bouton Exécuter.
  • Vous obtiendrez votre jeton d’authentification et une version (par ex. v1.0) de l’API, qui devraient être inclus dans l’en-tête http de toutes les requêtes http pour pouvoir vous authentifier auprès de l’API