Lister toutes vos imprimantes

Lister les imprimantes

GET https://www.expedy.fr/api/v2/printers/all

Renvoie toutes les imprimantes cloud rattachées à votre compte, avec leur UID, leur nom, leur statut et leur configuration. Utilisez-le pour découvrir le printer_uid dont vous avez besoin pour envoyer une tâche d'impression.

URL de base : https://www.expedy.fr/api/v2

Authentification

Ce endpoint nécessite un en-tête Authorization contenant votre SID et votre TOKEN, séparés par un seul deux-points.

Authorization: <SID>:<TOKEN>

⚠️ Ce n'est pas un jeton Bearer. N'ajoutez pas de préfixe Bearer ni Basic — envoyez la valeur brute SID:TOKEN.

Les deux valeurs sont disponibles dans la console Expedy, rubrique API. Toutes les requêtes doivent être effectuées en HTTPS (TLS).

Exemple cURL :

curl "https://www.expedy.fr/api/v2/printers/all" \
  -H "Authorization: <SID>:<TOKEN>"

Réponse `200 OK`

Renvoie un tableau JSON d'objets imprimante (tableau vide si aucune imprimante n'est enregistrée).

Champ	Type	Description
`printer_uid`	`string`	Identifiant unique de l'imprimante. C'est la valeur que vous passez en tant que `{printer_uid}` au endpoint d'impression.
`printer_name`	`string`	Libellé lisible défini dans la console (ex. `Kitchen`, `Lobby`).
`printer_status`	`string`	État d'activation de l'imprimante. `1` = active, `0` = suspendue. C'est un drapeau administratif contrôlé uniquement par ExpedyPRINT — pas un indicateur de connectivité en temps réel.
`printer_width`	`string`	Largeur du papier en millimètres : `58`, `80` ou `104`. Utilisez-la pour dimensionner votre contenu (32 / 48 caractères par ligne pour 58 / 80 mm).
`printer_graphic_mode`	`string`	Mode de rendu des images configuré dans la console : `0` = Graphics (par défaut), `1` = BitImageRaster, `2` = BitImageColumn. Voir Image et logo.
`printer_print_mode`	`string`	Code numérique du mode d'impression de l'imprimante (configuration spécifique à l'appareil).

ℹ️ printer_status est un drapeau d'activation, pas une vérification de connectivité en temps réel. 0 signifie que l'imprimante a été suspendue par ExpedyPRINT — généralement à cause d'un problème de paiement ou d'un non-respect de nos conditions générales d'utilisation — et elle n'imprimera pas tant qu'elle ne sera pas réactivée. Pour vérifier qu'un appareil actif est physiquement joignable et imprime, envoyez une impression de test plutôt que de vous fier à ce champ.

Exemple de réponse :

[
  {
    "printer_uid": "UP3VS5JXRYA",
    "printer_name": "Lobby",
    "printer_status": "1",
    "printer_width": "58",
    "printer_graphic_mode": "0",
    "printer_print_mode": "0"
  },
  {
    "printer_uid": "MMAAZ112PI",
    "printer_name": "Kitchen",
    "printer_status": "1",
    "printer_width": "80",
    "printer_graphic_mode": "0",
    "printer_print_mode": "0"
  },
  {
    "printer_uid": "8L35EGFH8S7",
    "printer_name": "Warehouse",
    "printer_status": "1",
    "printer_width": "104",
    "printer_graphic_mode": "0",
    "printer_print_mode": "1"
  }
]

Erreurs

Tout statut non 2xx renvoie une enveloppe JSON avec un champ message :

{
  "message": "Missing ExpedyPRINT API credentials (SID / token)."
}

Statut	Signification
`401` / `403`	Identifiants manquants ou invalides (`SID` / `TOKEN`).

Lisez toujours le champ message plutôt que de vous fier au seul code de statut.

Étape suivante

Une fois que vous avez un printer_uid, envoyez-lui du contenu :

POST https://www.expedy.fr/api/v2/printers/{printer_uid}/print

Voir la référence du endpoint d'impression pour le corps de la requête et les balises de mise en page.

SDK & exemples

Vous préférez un client prêt à l'emploi ? Utilisez le SDK officiel Node.js — il encapsule l'authentification et la liste des imprimantes :

👉 github.com/ExpedyDev/expedy-sdk-node