Skip to main content

PrintersApi

MethodHTTP requestDescription
create_printerPOST /api/web/v1/printersCreates a printer.
delete_printerDELETE /api/web/v1/printers/{printerId}Deletes a printer by ID.
delete_printer_with_tenant_idDELETE /api/web/v1/printers/{printerId}/{tenantId}Deletes a lost printer by printer id and lost tenant ID.
get_printersGET /api/web/v2/printersGets all printers.
printers_summaryGET /api/web/v1/printers/summaryRetrieve count of registered printers
read_printerGET /api/web/v1/printers/{printerId}Return a specified printer.
read_printer_by_device_idGET /api/web/v2/printers/{deviceId}Return a specified printer using printer device id.
read_printer_preferencesGET /api/web/v1/printers/{printerId}/preferencesGet the preferences for the specified printer.
read_printersGET /api/web/v1/printersGets all printers.
replace_printerPUT /api/web/v1/printers/{printerId}Update the specified printer.
replace_printer_preferencesPUT /api/web/v1/printers/{printerId}/preferencesUpdate the preferences for the specified printer.

create_printer

ResourceIdResponse create_printer(printer)

Creates a printer.

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
printerPrinter

Return type

ResourceIdResponse

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
202Accepted-
400Bad request-
401Authorization information is missing or invalid-
409Conflict, printer already exists with the given Name or Device ID.-
500Unexpected error-

delete_printer

delete_printer(printer_id)

Deletes a printer by ID.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
printer_idstrThe unique 32-36 character id obtained from the Get All Printers request. Example - 0b0db90a-6091-416f-8559-2f2181e941c3

Return type

void (empty response body)

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200OK-
400Bad request-
401Authorization information is missing or invalid-
404The specified resource was not found-
500Unexpected error-

delete_printer_with_tenant_id

delete_printer_with_tenant_id(printer_id, tenant_id)

Deletes a lost printer by printer id and lost tenant ID.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
printer_idstrPrinter ID
tenant_idstrPrinter ID

Return type

void (empty response body)

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

HTTP response details

Status codeDescriptionResponse headers
200OK-

get_printers

List[Printer] get_printers()

Gets all printers.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

This endpoint does not need any parameter.

Return type

List[Printer]

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200OK-
400Bad request-
401Authorization information is missing or invalid-
500Unexpected error-

printers_summary

PrinterSummaryResponse printers_summary()

Retrieve count of registered printers

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

This endpoint does not need any parameter.

Return type

PrinterSummaryResponse

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successfully retreived printer summary-
400Bad request-
401Authorization information is missing or invalid-
500Unexpected error-

read_printer

Printer read_printer(printer_id)

Return a specified printer.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
printer_idstrThe unique 32-36 character id obtained from the Get All Printers request. Example - 0b0db90a-6091-416f-8559-2f2181e941c3

Return type

Printer

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200OK-
400Bad request-
401Authorization information is missing or invalid-
404The specified resource was not found-
500Unexpected error-

read_printer_by_device_id

Printer read_printer_by_device_id(device_id)

Return a specified printer using printer device id.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
device_idstrThe unique 16 character id obtained from the printer LCD. Example - F71523262A998271

Return type

Printer

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200OK-
400Bad request-
401Authorization information is missing or invalid-
404The specified resource was not found-
500Unexpected error-

read_printer_preferences

PrinterPreferences read_printer_preferences(printer_id)

Get the preferences for the specified printer.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
printer_idstrThe unique 32-36 character id obtained from the Get All Printers request. Example - 0b0db90a-6091-416f-8559-2f2181e941c3

Return type

PrinterPreferences

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200OK-
400Bad request-
401Authorization information is missing or invalid-
404The specified resource was not found-
500Unexpected error-

read_printers

List[Printer] read_printers(fields=fields, with_status=with_status)

Gets all printers.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
fieldsstrThe model properties to return.[optional]
with_statusboolIndicates if the current status of each printer is retrieved. Defaults to false if not specified.[optional]

Return type

List[Printer]

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200OK-
400Bad request-
401Authorization information is missing or invalid-
500Unexpected error-

replace_printer

replace_printer(printer_id, printer)

Update the specified printer.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
printer_idstrThe unique 32-36 character id obtained from the Get All Printers request. Example - 0b0db90a-6091-416f-8559-2f2181e941c3
printerPrinter

Return type

void (empty response body)

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200OK-
400Bad request-
401Authorization information is missing or invalid-
404The specified resource was not found-
500Unexpected error-

replace_printer_preferences

replace_printer_preferences(printer_id, printer_preferences)

Update the preferences for the specified printer.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
printer_idstrThe unique 32-36 character id obtained from the Get All Printers request. Example - 0b0db90a-6091-416f-8559-2f2181e941c3
printer_preferencesPrinterPreferences

Return type

void (empty response body)

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200OK-
400Bad request-
401Authorization information is missing or invalid-
404The specified resource was not found-
500Unexpected error-