Netzwerk-API für Druckereien & Großkunden

So funktioniert es

Sie erhalten von uns zwei Schlüssel: einen Test-Schlüssel (vn_test_…, gedrosselt – zum gefahrlosen Entwickeln) und nach erfolgreichem Test einen Produktions-Schlüssel (vn_live_…). Jede Anfrage trägt den Schlüssel im Header:

Authorization: Bearer vn_live_ihrschluessel

Die wichtigsten Aufrufe

Auftraggeber (Mandant) anlegen:

curl -X POST https://verpackungsnachweis.de/api/v1/auftraggeber \
  -H "Authorization: Bearer vn_test_..." -H "Content-Type: application/json" \
  -d '{"anzeigeName":"Honig Meier","erzeugerName":"Imkerei Meier e.K.",
       "erzeugerAnschrift":"Bienenweg 3, 01917 Kamenz","erzeugerKontakt":"info@honig-meier.de"}'

Nachweis für diesen Auftraggeber erzeugen (liefert die dauerhafte QR-URL):

curl -X POST https://verpackungsnachweis.de/api/v1/nachweise \
  -H "Authorization: Bearer vn_test_..." -H "Content-Type: application/json" \
  -d '{"titel":"Honigglas 500 g","auftraggeberId":"<id aus Schritt 1>"}'

Konformitätserklärung (PDF) hochladen – durchläuft automatisch Virenscan und Prüfung:

curl -X POST "https://verpackungsnachweis.de/api/v1/nachweise/<id>/dokument?dateiname=doc.pdf" \
  -H "Authorization: Bearer vn_test_..." -H "Content-Type: application/pdf" \
  --data-binary @konformitaetserklaerung.pdf

Druckfertigen QR-Code bzw. Etikett herunterladen:

curl -H "Authorization: Bearer vn_test_..." -o qr.eps \
  https://verpackungsnachweis.de/api/v1/nachweise/<id>/qr.eps
curl -H "Authorization: Bearer vn_test_..." -o etikett.pdf \
  "https://verpackungsnachweis.de/api/v1/nachweise/<id>/etikett.pdf?b=62&h=29"

Vollständige Beschreibung

Die komplette Schnittstellenbeschreibung als OpenAPI 3.0 (für Postman, Swagger-Tools oder Code-Generatoren): openapi.yaml herunterladen

Gut zu wissen

Formate für QR-Downloads: svg, png, eps (für Druckvorstufe) und pdf; Etiketten-PDFs millimetergenau über ?b= und ?h= (20–150 mm). Test-Schlüssel sind auf wenige Anfragen pro Stunde gedrosselt, Produktions-Schlüssel großzügig bemessen – das verbleibende Kontingent steht in jeder Antwort im Header X-RateLimit-Remaining. Einmal erzeugte QR-URLs (/n/…) bleiben dauerhaft stabil – auch wenn Sie Dokumente später aktualisieren. Hochgeladene PDFs werden virengeprüft und bei aktiven Inhalten automatisch neutralisiert.