Label Compliance Check API

Ablauf

Der Label Compliance Check verbindet die DPP-Labels-Website mit einem n8n-Workflow. Das Frontend laedt ein Etikett-Bild hoch, der PHP-Server leitet es an n8n weiter, und das Frontend pollt, bis n8n die Ergebnisse zurueck-POSTet.

Was n8n empfaengt (Submit → n8n)

Wenn ein Benutzer ein Etikett hochlaedt, sendet der PHP-Server eine multipart/form-data-Anfrage an die konfigurierte LABEL_CHECK_WEBHOOK_URL.

payload ist ein JSON-String und kann in n8n mit JSON.parse($json.body.payload) geparst werden. Der Payload enthaelt schema_version, source, Job-Felder sowie filename, mime_type, file_size und file_sha256. email ist beim initialen Upload immer null.

Authentifizierungs-Header:

# Beispiel: So sieht der Request an n8n aus
curl -X POST https://your-n8n.com/webhook/label-check \
  -H "X-Api-Key: <LABEL_CHECK_API_KEY>" \
  -F "file=@etikett.jpg" \
  -F "job_id=a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6" \
  -F "label_type=wein" \
  -F "callback_url=https://dpp-labels.eu/api/label-check/callback" \
  -F 'payload={"schema_version":"1.1","source":"dpp-labels-label-check","job_id":"a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6","status":"pending","label_type":"wein","callback_url":"https://dpp-labels.eu/api/label-check/callback","submitted_at":"2026-07-10T10:00:00+02:00","completed_at":null,"email_claimed":false,"email":null,"filename":"label.jpg","mime_type":"image/jpeg","file_size":123456,"file_sha256":"..."}'

Der Server versucht den n8n-Start-Webhook bis zu 3-mal mit je 8 Sekunden Timeout. HTTP <400 gilt als angenommen; Diagnosewerte werden ohne Secret-Werte in Jobdaten und Serverlog gespeichert.

POST /api/label-check/submit

Frontend-Endpunkt: Bild hochladen und Analyse starten.

Erfolgsantwort 202 Accepted

{
  "job_id": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
  "status": "pending"
}

Fehlerantworten

POST /api/label-check/callback (n8n → PHP)

n8n ruft diesen Endpunkt auf, sobald die Analyse abgeschlossen ist. Wenn LABEL_CHECK_CALLBACK_SECRET konfiguriert ist, muss der Request den passenden Header X-Callback-Secret enthalten.

Header

Body — Ergebnis-JSON

{
  "job_id": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
  "status": "complete",
  "label_type": "wein",
  "overall_score": 72,
  "categories": [
    {
      "name": "Pflichtangaben",
      "status": "pass",
      "teaser": "Alle gesetzlichen Mindestangaben vorhanden."
    },
    {
      "name": "EU-Lebensmittelrecht",
      "status": "warn",
      "teaser": "1 Angabe unvollstaendig oder fehlend."
    },
    {
      "name": "DPP-Bereitschaft",
      "status": "fail",
      "teaser": "Kein QR-Code / Digital Link erkannt."
    },
    {
      "name": "Sprachkonformitaet",
      "status": "pass",
      "teaser": "Sprachliche Anforderungen erfuellt."
    }
  ],
  "findings": [
    {
      "id": "f1",
      "severity": "warn",
      "title": "Naehrwertkennzeichnung unvollstaendig",
      "teaser_text": "Ballaststoffe und Salz fehlen in der Tabelle.",
      "full_text": "Gemaess EU 1169/2011 Art. 30 Abs. 1 muessen folgende Naehrwerte …"
    },
    {
      "id": "f2",
      "severity": "fail",
      "title": "Kein GS1 Digital Link erkannt",
      "teaser_text": "Kein QR-Code oder Digital-Link-URI auf dem Etikett gefunden.",
      "full_text": "Die EU-ESPR-Verordnung (Entwurf) sieht ab 2027 …"
    }
  ]
}

Datenvertrag im Detail

Root-Felder

categories[*]

Status-Werte (Ampel-System)

findings[*]

GET /api/label-check/status

Das Frontend pollt diesen Endpunkt alle 5 Sekunden, um den aktuellen Status abzufragen.

Antwort (ausstehend)

{
  "job_id": "a1b2c3d4…",
  "status": "pending",
  "submitted_at": "2026-07-08T10:00:00+02:00",
  "label_type": "wein"
}

Antwort (abgeschlossen)

Gibt das komplette Job-Objekt inkl. result zurueck. Das Feld visitor_email wird aus Datenschutzgruenden entfernt.

POST /api/label-check/claim

Besucher gibt seine E-Mail-Adresse ein, um den vollstaendigen Compliance-Bericht zu erhalten.

Umgebungsvariablen (.env)

# .env
LABEL_CHECK_WEBHOOK_URL=https://your-n8n.com/webhook/label-check
LABEL_CHECK_API_KEY=dpp-lc-key-abc123
LABEL_CHECK_CALLBACK_SECRET=generate-a-random-secret-here

Job-Dateistruktur

Jeder Analyse-Job wird als JSON gespeichert unter:

content/label-compliance-check/{job_id}.json

Lebenszyklus

Fehlerbehandlung