API documentation

This page describes the only public HTTP API documented here: a minimal lookup of a product by EAN / barcode.

Lookup by EAN

Returns the stored EAN, manufacturer name, and product name. No authentication.

Method
GET
URL
/api/ean/<ean_code>
Path parameter
ean_code — barcode string (URL path; use standard encoding for special characters). Leading/trailing spaces are trimmed. Empty after trim yields 422.

Response 200 OK

JSON object:

{
  "ean": "string",
  "manufacturer": "string | null",
  "product_name": "string"
}

Error responses

  • 404 — EAN not in the database, or linked product row is missing. Body typically includes a message string.
  • 422 — Path present but empty after trimming.

Example

curl -sS "https://<host>/api/ean/5701234567890"

Other endpoints may exist on this server; they are not covered by this page.