API DEVICE V1 : Introduction

NOUVELLE VERSION V2 : CLIQUEZ-ICI

Vous êtes développeur ou une agence web ? Inscrivez-vous au programme Expedy Partner

La présente section décrit les principales fonctionnalités pour permettre l’interconnexion d’une machine Expedy avec des sites web extérieurs, ou toute autre application connectée au web.

Sauf indication, toutes les requêtes sont faites en “post”

Tous les appels sont sécurisés par une clé de contrôle :
           SID : “XXXXXXXXXXXXXXXXXXXXXXXXXXX”
           TOKEN : “XXXXXXXXXXXXXXXXXXXXXXXXXXX”

Cette clé est accessible dans votre espace client sur https://www.expedy.fr/console

Si vous n’avez pas reçu vos identifiants Expedy veuillez contacter le support.

Le Web Service mis à disposition par Expedy est le suivant :
https://www.expedy.fr/api/device/nom_du_service

Liste des services EXPEDY DEVICE V1 :

endpoints d’Administration

/device/status
/device/ping
/device/update
/device/reboot
/device/shutdown

endpoints Wifi

/device/wifi/conf
/device/wifi/add
/device/wifi/del
/device/wifi/update

endpoints Usb/Impression

/device/usb/conf
/device/usb/scan
/device/usb/scan/read
/device/usb/print

L’une des méthodes la plus simple pour dialoguer avec un Web Service en PHP consiste en l’utilisation de la fonction « curl ».

Contactez notre équipe support si vous souhaitez obtenir des exemples avec d’autres langages de programmation.

Gestion des erreurs

En cas d’erreur de communication de classe 4xx, 5xx avec l’api, la fonction curl de votre langage peut vous retourner la/les raisons.

En cas de communication valide avec l’API, mais avec des erreurs d’argument ou dans la requête, une réponse d’erreur est retournée, comprenant une explication, exemple:
{“status”:”error”,”error”:”rpi_uid is empty”}

En cas de requêtes valide, la valeur retournée de status est toujours “ok”.