Printer Drivers

Printer drivers act as translator between the applications that creates print jobs and the printer hardware. Printer that are connected to ezeep Print Server Connectors usually can render jobs itself, but jobs targeted to embedded ezeep Print Connectors as well as printers connected to an ezeep Hub need to be rendered on ezeep Rendering Service by a printer driver.

Get all Vendors List

Many vendors are available in the ezeep Rendering Service. To use the printer connected to ezeep Print Connector not running on a printer driver capable device/machine, it is important to assign the correct driver. If any vendor or model is not available in the response then client can send email to helpdesk@ezeep.com for help.

To get the list of vendors, run the following request. The response is a list of vendor names.

GET "https://api2.ezeep.com/printing/v1/drivers/vendors/"

Example Request

curl  -X GET "https://api2.ezeep.com/printing/v1/drivers/vendors/" \
      --header "Authorization: Bearer <access_token>"

Example Response

[
  "Apollo",
  "Avery",
  "BIXOLON",
  "Boca",
  "Brother",
  "cab",
  "Canon",
  "Casio",
  "Citizen",
  "Cognitive",
  "Datamax-O'Neil",
  "Dell",
  "DYMO",
  "ELGIN",
  "Epson",
  "Foobar",
  "Fuji Xerox",
  "Fujitsu",
  "Generic",
  "Gestetner",
  "Honywell",
  "HP",
  "IBM",
  "Imagio",
  "InfoPrint",
  "infotec",
  "Infotech",
  "KIP",
  "KONICA",
  "Kyocera",
  "Lanier",
  "Lenovo",
  "Lexmark",
  "LG",
  "Microsoft",
  "Multi-model",
  "Munbyn",
  "NEC",
  "NRG",
  "OCE",
  "OKI",
  "Other",
  "Panasonic",
  "Panduit",
  "Pantum",
  "PCL6",
  "Printronix",
  "Ricoh",
  "Samsung",
  "Savin",
  "Sharp",
  "Smart",
  "Sony",
  "Star",
  "Tally",
  "Tektronix",
  "Toshiba",
  "Triumph Adler",
  "TSC",
  "TYPE",
  "UTAX",
  "UTAX_TA",
  "WiPro",
  "Xerox",
  "ZDesigner",
  "Zebra"
]

Get Specific Vendor Driver List

To get a list of available drivers for a given vendor, call:

GET "https://api2.ezeep.com/printing/v1/drivers/?vendor=<vendor_name>"

Parameters:

Attribute	Type	Required	Description
id	string	no	uuid
name	string	no	Printer name
readable_name	string	no
vendor	string	yes	name of the printer vendor
os	string	no	“Linux”, “Windows”, “Windows CE”
arch	string	no
blob_capabilities	object	no	default printer capabilities provided by the driver, see Blob Capabilities

Example Request

curl  -X GET "https://api2.ezeep.com/printing/v1/drivers/?vendor=Lenovo" \
      --header "Authorization: Bearer <access_token>"

Example Response

In the example response, two drivers are available for the vendor Lenovo.

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "cc204437-ddda-4e70-a335-845a646f682e",
      "name": "Lenovo LJ3800DN",
      "readable_name": "Lenovo LJ3800DN",
      "vendor": "Lenovo",
      "os": "Windows",
      "arch": "x64",
      "printers_using_driver": 1,
      "blob_capabilities": {
        "options": 2,
        "count": 6,
        "capabilities": "H4sIAAAAAAACC41V224TQQz1p+wjVEXanZm9zGMaWombhAT9gKiEgtQ2UikIfizfx/GxZ5JNQkVWm/WOx8f2scd7JqOcy0J+ypNspJFPspY73Dd4F+mg+yyPspI/kEWC9DJh7YN8xN6iEUlcW8kDcFaw11/GWoBVi0ulDE8tfSXZ4g6Q7T9gvQOyShOuBOsz+g5cN6QRT/XzHtE94VrD+zHOyD2BvjJw+hlKxLOXwVFuGesW73GGESlFrIzMWhnqGJfFNODStUv5TaaUu+/yC/Icq6O9xaO8BTLaUZPw3s4YWmCP2rd79rFmbwwJ9M/ZN8hrgyrcQrqUL3iu/wPT6qI4vUsFfQHbuX1mJQ0n0zoyQ8118Ih6j+jiREYD7XRXoh8hnxN12f1b9Vrf/w65vHBtA8Yb1zdyj+vlkYfJIwzkqncPuxq2rjv2oNriYXjGw8hoLNNdDtlzsGw0xngih3EvhzjzEGc57HotMYeOesuusGx1eytvcGqbf7CdK9tTjdTqFWq1S+UujqrdcV92rNERSrcksmqV1OiW6L17eUXdPKNco44848L8Db/Mh+DSa/TwYc+NdZoUviePKVTrTGl5goVUWQiMWnt2JO7kXGT2vs4wPT0rTJYb+XaQw+STo9RAvMPOyV9wTq0m0avcH2AMPH2W9+R1TQcTSrtG914hljvMlc0zEyqweuIdVyZsqlwusGfryKWjJvJh78Zm57h9jX7wc7LrrXTAqlY97c1UY3V/Tie8d4xMZ63Nose9aIL391hz09ztGzOcZPVafhCjQY+s5Su4eSDy/CugiOOMYyGnLb8qg0udc6S/xm/h+8Ra726bt1J5sgoJe9q8CXi2iun3xmK+IpLKLSesWWqnLbkyVF3y8yT1PIpPjkCvfwErgygWogcAAA=="
      }
    },
    {
      "id": "5c7c7372-8d32-4a23-9490-67328264e7a1",
      "name": "Lenovo LJ3700D",
      "readable_name": "Lenovo LJ3700D",
      "vendor": "Lenovo",
      "os": "Windows",
      "arch": "x64",
      "printers_using_driver": 0,
      "blob_capabilities": {
        "options": 2,
        "count": 6,
        "capabilities": "H4sIAAAAAAACC41V224TQQz1p+wjVEXanZm9zGMaWombhAT9gKiEgtQ2UikIfizfx/GxZ5JNQkVWm/WOx8f2scd7JqOcy0J+ypNspJFPspY73Dd4F+mg+yyPspI/kEWC9DJh7YN8xN6iEUlcW8kDcFaw11/GWoBVi0ulDE8tfSXZ4g6Q7T9gvQOyShOuBOsz+g5cN6QRT/XzHtE94VrD+zHOyD2BvjJw+hlKxLOXwVFuGesW73GGESlFrIzMWhnqGJfFNODStUv5TaaUu+/yC/Icq6O9xaO8BTLaUZPw3s4YWmCP2rd79rFmbwwJ9M/ZN8hrgyrcQrqUL3iu/wPT6qI4vUsFfQHbuX1mJQ0n0zoyQ8118Ih6j+jiREYD7XRXoh8hnxN12f1b9Vrf/w65vHBtA8Yb1zdyj+vlkYfJIwzkqncPuxq2rjv2oNriYXjGw8hoLNNdDtlzsGw0xngih3EvhzjzEGc57HotMYeOesuusGx1eytvcGqbf7CdK9tTjdTqFWq1S+UujqrdcV92rNERSrcksmqV1OiW6L17eUXdPKNco44848L8Db/Mh+DSa/TwYc+NdZoUviePKVTrTGl5goVUWQiMWnt2JO7kXGT2vs4wPT0rTJYb+XaQw+STo9RAvMPOyV9wTq0m0avcH2AMPH2W9+R1TQcTSrtG914hljvMlc0zEyqweuIdVyZsqlwusGfryKWjJvJh78Zm57h9jX7wc7LrrXTAqlY97c1UY3V/Tie8d4xMZ63Nose9aIL391hz09ztGzOcZPVafhCjQY+s5Su4eSDy/CugiOOMYyGnLb8qg0udc6S/xm/h+8Ra726bt1J5sgoJe9q8CXi2iun3xmK+IpLKLSesWWqnLbkyVF3y8yT1PIpPjkCvfwErgygWogcAAA=="
      }
    }
  ]
}

Printer Driver Assignment

To assign drivers to a printers, the uuid of the printer and the uuid of the driver is needed. Here we describe how to get the information of any printer connected to an ezeep Connector. In above example request it is given how to get driver_id.

PATCH "https://api2.ezeep.com/printing/v1/printers/<printer_id>/"

Parameters:

Attribute	Type	required	description
id	string	yes	uuid of Printer
driver_id	string	yes	uuid of the driver
name	string	no	unique name of printer (max 255 chars)
status	string	no	“Online”, “Offline”, “Inproperly Configured” (printer status)
connector_id	string	no	uuid of connector the printer belongs to
tp_id	integer	no	unique printer id (1-2147483646) per connector
supported_formats	string array	no	“RAW”, “PDF”, “XPS”
vendor_name	string	no	string (max_len: 255)
model_name	string	no	string (max_len: 255)
location	string	no	string
pnp_id	string	no	IEEE1284 PnP id string

Example Request

curl  -X PATCH "https://api2.ezeep.com/printing/v1/printers/420309d2-0ae4-46ac-a7c6-61d5878fda93/" \
      --header "Authorization: Bearer <access_token>" \
      --header "Content-Type: application/json" \
      --data '{
                "driver_id": "cc204437-ddda-4e70-a335-845a646f682e"
              }'

Example Response

In the example response, manual_driver_id contains the assigned Lenovo driver.

{
  "id": "420309d2-0ae4-46ac-a7c6-61d5878fda93",
  "name": "HP Color LaserJet MFP M477fdn",
  "tp_id": 1,
  "status": "Online",
  "vendor_name": "",
  "model_name": "HP Color LaserJet MFP M477fdn",
  "location": "",
  "connector_id": "534fcfcf-0dbc-4d14-844b-cba482e20b06",
  "driver_id": null,
  "manual_driver_id": "cc204437-ddda-4e70-a335-845a646f682e",
  "supported_formats": [],
  "blob_capabilities": {
    "Options": 2,
    "Count": 6,
    "Capabilities": "H4sIAAAAAAACC41V224TQQz1p+wjVEXanZm9zGMaWombhAT9gKiEgtQ2UikIfizfx/GxZ5JNQkVWm/WOx8f2scd7JqOcy0J+ypNspJFPspY73Dd4F+mg+yyPspI/kEWC9DJh7YN8xN6iEUlcW8kDcFaw11/GWoBVi0ulDE8tfSXZ4g6Q7T9gvQOyShOuBOsz+g5cN6QRT/XzHtE94VrD+zHOyD2BvjJw+hlKxLOXwVFuGesW73GGESlFrIzMWhnqGJfFNODStUv5TaaUu+/yC/Icq6O9xaO8BTLaUZPw3s4YWmCP2rd79rFmbwwJ9M/ZN8hrgyrcQrqUL3iu/wPT6qI4vUsFfQHbuX1mJQ0n0zoyQ8118Ih6j+jiREYD7XRXoh8hnxN12f1b9Vrf/w65vHBtA8Yb1zdyj+vlkYfJIwzkqncPuxq2rjv2oNriYXjGw8hoLNNdDtlzsGw0xngih3EvhzjzEGc57HotMYeOesuusGx1eytvcGqbf7CdK9tTjdTqFWq1S+UujqrdcV92rNERSrcksmqV1OiW6L17eUXdPKNco44848L8Db/Mh+DSa/TwYc+NdZoUviePKVTrTGl5goVUWQiMWnt2JO7kXGT2vs4wPT0rTJYb+XaQw+STo9RAvMPOyV9wTq0m0avcH2AMPH2W9+R1TQcTSrtG914hljvMlc0zEyqweuIdVyZsqlwusGfryKWjJvJh78Zm57h9jX7wc7LrrXTAqlY97c1UY3V/Tie8d4xMZ63Nose9aIL391hz09ztGzOcZPVafhCjQY+s5Su4eSDy/CugiOOMYyGnLb8qg0udc6S/xm/h+8Ra726bt1J5sgoJe9q8CXi2iun3xmK+IpLKLSesWWqnLbkyVF3y8yT1PIpPjkCvfwErgygWogcAAA=="
  },
  "pnp_id": "",
  "auto_driver_assignment_state": "SKIPPED",
  "can_modify_favorite": false,
  "is_favorite": false
}