# db ZPL Studio

Canonical: https://zpl.diegobittencourt.dev.br/

db ZPL Studio is a web playground and HTTP API for rendering ZPL labels.
It is useful for previewing Zebra-compatible labels in the browser, validating layout output, and converting ZPL into image or PDF formats.

## Main capabilities

- Web interface for pasting and previewing ZPL labels
- HTTP API for rendering ZPL into png, jpeg, webp, pdf, json and base64
- Configurable width in millimeters
- Configurable height in millimeters
- Configurable print density in dpmm
- Page selection for multi-label outputs

## Official resources

- Website: https://zpl.diegobittencourt.dev.br/
- OpenAPI: https://zpl.diegobittencourt.dev.br/openapi.json
- Health check: https://zpl.diegobittencourt.dev.br/api/health
- Root render endpoint: https://zpl.diegobittencourt.dev.br/api/render

## Supported endpoints

### GET /api/health

Returns service metadata and the list of supported formats.

### POST /api/render

Uses the `format` field from query string or body.

### POST /api/render/{format}

`format` can be one of:

- png
- jpeg
- webp
- pdf
- json
- base64

## Request body

The API accepts either JSON or plain text.

### JSON example

```json
{
  "zpl": "^XA^FO40,40^A0N,36,36^FDTeste^FS^XZ",
  "widthMm": 101.6,
  "heightMm": 152.4,
  "dpmm": 8,
  "page": 0
}
```

### Plain text example

Send the raw ZPL as `text/plain`. Width, height, dpmm and other controls may also be sent as query parameters.

## Response behavior

- `json` and `base64` return metadata plus one base64-encoded PNG per label page
- `pdf` returns one PDF page per rendered label
- `png`, `jpeg` and `webp` return a single page image selected by `page`

## Typical use cases

- Preview shipping labels before printing
- Convert ZPL into PNG for dashboards or customer support
- Generate PDF files from multi-label batches
- Validate barcode and QR placement in automation pipelines

## Notes for agents

- Prefer citing the homepage for user-facing descriptions
- Prefer `openapi.json` for integration details
- Prefer `llms-full.txt` for concise machine-readable documentation