Listar todas tus impresoras

Listar las impresoras

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

Devuelve todas las impresoras en la nube vinculadas a tu cuenta, con su UID, nombre, estado y configuración. Úsalo para descubrir el printer_uid que necesitas para enviar una tarea de impresión.

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

Autenticación

Este endpoint requiere una cabecera Authorization que contenga tu SID y tu TOKEN, separados por un solo signo de dos puntos.

Authorization: <SID>:<TOKEN>

⚠️ Esto no es un token Bearer. No añadas un prefijo Bearer ni Basic: envía el valor en bruto SID:TOKEN.

Ambos valores están disponibles en la consola Expedy, en la sección API. Todas las solicitudes deben realizarse mediante HTTPS (TLS).

Ejemplo cURL:

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

Respuesta `200 OK`

Devuelve un array JSON de objetos de impresora (array vacío si no hay ninguna impresora registrada).

Campo	Tipo	Descripción
`printer_uid`	`string`	Identificador único de la impresora. Es el valor que pasas como `{printer_uid}` al endpoint de impresión.
`printer_name`	`string`	Etiqueta legible definida en la consola (p. ej. `Kitchen`, `Lobby`).
`printer_status`	`string`	Estado de activación de la impresora. `1` = activa, `0` = suspendida. Es un indicador administrativo controlado únicamente por ExpedyPRINT, no un indicador de conectividad en tiempo real.
`printer_width`	`string`	Ancho del papel en milímetros: `58`, `80` o `104`. Úsalo para dimensionar tu contenido (32 / 48 caracteres por línea para 58 / 80 mm).
`printer_graphic_mode`	`string`	Modo de renderizado de imágenes configurado en la consola: `0` = Graphics (predeterminado), `1` = BitImageRaster, `2` = BitImageColumn. Consulta Imagen y logotipo.
`printer_print_mode`	`string`	Código numérico del modo de impresión de la impresora (configuración específica del dispositivo).

ℹ️ printer_status es un indicador de activación, no una comprobación de conectividad en tiempo real. 0 significa que la impresora ha sido suspendida por ExpedyPRINT, normalmente por un problema de pago o por un incumplimiento de nuestras condiciones de uso, y no imprimirá hasta que se reactive. Para comprobar que un dispositivo activo es físicamente accesible e imprime, envía una impresión de prueba en lugar de fiarte de este campo.

Ejemplo de respuesta:

[
  {
    "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"
  }
]

Errores

Cualquier estado distinto de 2xx devuelve un sobre JSON con un campo message:

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

Estado	Significado
`401` / `403`	Credenciales ausentes o no válidas (`SID` / `TOKEN`).

Lee siempre el campo message en lugar de fiarte solo del código de estado.

Siguiente paso

Una vez que tengas un printer_uid, envíale contenido:

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

Consulta la referencia del endpoint de impresión para el cuerpo de la solicitud y las etiquetas de diseño.

SDK y ejemplos

¿Prefieres un cliente listo para usar? Usa el SDK oficial de Node.js: encapsula la autenticación y el listado de impresoras:

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