SoftPrint

SoftPrint API

Imprime desde tu aplicación.

Gestuu, SoftPrint Tasks o cualquier otro cliente pueden solicitar una impresión con la misma API HTTP. Tu integración utiliza impresoras lógicas y documentos neutrales, sin conocer Star, CloudPRNT ni el transporte físico.

De tu código al papel en cuatro pasos

  1. Solicita una API key con los permisos mínimos para tu aplicación. Las claves se emiten de forma administrada; no hay registro público.
  2. Obtén una impresora lógica autorizada con GET /v1/printers.
  3. Envía POST /v1/print-jobs con un SoftPrint Document y una Idempotency-Key persistida por intención.
  4. Consulta GET /v1/print-jobs/{id} hasta el estado final o recibe un webhook firmado.
SoftPrint Document 1.0
{
  "printer": "mi-impresora",
  "document": {
    "version": "1.0",
    "blocks": [
      { "type": "text", "text": "Hola desde mi aplicación" }
    ]
  }
}

Una respuesta 202 confirma la aceptación, no que haya salido papel. Si se pierde la respuesta, reenvía exactamente el mismo cuerpo con la misma clave de idempotencia.