Barcodes
Base route: /api/v1/barcodes
Saved barcodes are static tenant assets. They are protected by the current workspace membership, role, subscription and API-key scope on every call.
| Method | Endpoint | Scope | Purpose |
|---|---|---|---|
GET |
/api/v1/barcodes |
barcode:read |
List/search/filter saved barcodes. |
GET |
/api/v1/barcodes/{id} |
barcode:read |
Retrieve one barcode and safe SVG preview. |
POST |
/api/v1/barcodes |
barcode:write |
Create a saved barcode. |
PUT |
/api/v1/barcodes/{id} |
barcode:write |
Update value/name/appearance. |
GET |
/api/v1/barcodes/{id}/download?format=png |
barcode:read |
Download PNG, SVG or PDF. |
DELETE |
/api/v1/barcodes/{id} |
barcode:delete |
Soft-delete a barcode. |
Supported standards: Code128, Ean13, UpcA, Ean8, Code39, Itf14. GS1-style formats validate or calculate their check digit.
{
"name": "Warehouse SKU 4821",
"format": "Code128",
"value": "SKU-4821",
"style": {
"showText": true,
"height": 96,
"scale": 3,
"foregroundColor": "#102A2A",
"backgroundColor": "#FFFFFF"
}
}
The renderer is server-side, bounded and network-independent. QRalto rejects invalid standards, oversized values/exports and unsafe low-contrast colour combinations.