Getting Started

Schritt 1: API Key erstellen

Ein einziger Call — kein E-Mail, kein Passwort noetig:

curl -X POST https://enricha.dev/v1/auth/keys

Response:

{
"api_key": "enr_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
"key_prefix": "enr_a1b2c3d4",
"message": "Save this key now — it will not be shown again."
}

Key sicher aufbewahren: Der vollstaendige API Key wird nur einmal angezeigt. Speichere ihn sofort in deinem Passwort-Manager oder .env-Datei.

Schritt 2: Erster API Call

Sende ein Produkt an den Enrichment-Endpoint:

curl -X POST https://enricha.dev/v1/enrich \
-H "Authorization: Bearer enr_dein_api_key" \
-H "Content-Type: application/json" \
-d '{
  "product_name": "Riesling Spaetlese 2024",
  "brand": "Weingut Mueller",
  "net_content": "750ml",
  "description": "Weisswein, trocken, Rheingau"
}'

import httpx

response = httpx.post(
  "https://enricha.dev/v1/enrich",
  headers={"Authorization": "Bearer enr_dein_api_key"},
  json={
      "product_name": "Riesling Spaetlese 2024",
      "brand": "Weingut Mueller",
      "net_content": "750ml",
      "description": "Weisswein, trocken, Rheingau",
  },
)
data = response.json()
print(f"GPC Brick: {data['gpc']['brick_name']} ({data['gpc']['confidence']:.0%})")
print(f"DQX Score: {data['dqx']['score']}/100")

const response = await fetch("https://enricha.dev/v1/enrich", {
method: "POST",
headers: {
  "Authorization": "Bearer enr_dein_api_key",
  "Content-Type": "application/json",
},
body: JSON.stringify({
  product_name: "Riesling Spaetlese 2024",
  brand: "Weingut Mueller",
  net_content: "750ml",
  description: "Weisswein, trocken, Rheingau",
}),
});
const data = await response.json();
console.log(`GPC Brick: ${data.gpc.brick_name} (${data.gpc.confidence})`);
console.log(`DQX Score: ${data.dqx.score}/100`);

Request-Felder

Feld	Pflicht	Beschreibung
`product_name`	Ja	Produktname
`description`	Nein	Produktbeschreibung
`brand`	Nein	Markenname
`net_content`	Nein	Inhalt, z.B. “750ml”, “500g”
`ingredients`	Nein	Zutatenliste
`category_hint`	Nein	Kategorie-Hinweis, z.B. “Wein”
`ean`	Nein	EAN/GTIN Barcode
`target_market`	Nein	ISO 3166-1 Laendercode, z.B. “276” (Deutschland, Default)
`market_stage`	Nein	”list_order”, “move_store” oder “sell” (Default)

Je mehr Felder du mitgibst, desto besser die Ergebnisse.

Schritt 3: Response verstehen

Die API antwortet mit einem vollstaendigen Datensatz:

{
"enrichment_id": "550e8400-e29b-41d4-a716-446655440000",
"gpc": {
  "brick_code": "10000266",
  "brick_name": "Wein - Still",
  "confidence": 0.94,
  "hierarchy": [
    {"code": "50000000", "name": "Food/Beverage/Tobacco"},
    {"code": "50200000", "name": "Getraenke"},
    {"code": "50202200", "name": "Wein"},
    {"code": "10000266", "name": "Wein - Still"}
  ],
  "alternatives": [],
  "strategy": "two_pass"
},
"attributes": {
  "mandatory": [
    {
      "attribute_name": "tradeItemDescription",
      "display_name": "Trade Item Description",
      "value": "Riesling Spaetlese 2024 Weingut Mueller",
      "source": "input_mapped",
      "confidence": 1.0,
      "requirement": "mandatory"
    }
  ],
  "optional": []
},
"dqx": {
  "score": 92,
  "passed": true,
  "errors": [],
  "warnings": [
    {
      "rule_id": "DQX-005",
      "message": "Low confidence on attribute: countryOfOrigin",
      "severity": "warning",
      "attribute": "countryOfOrigin"
    }
  ]
},
"metadata": {
  "credits_used": 1,
  "credits_remaining": 99,
  "processing_time_ms": 2340,
  "model_version": "mistral-small-latest",
  "tokens_used": 1850,
  "reference_data_version": "2026-Q1",
  "gdm_version": "2.16",
  "gdsn_version": "3.1.35"
}
}

Response-Bereiche

Bereich	Beschreibung
`gpc`	GPC-Klassifikation mit Brick-Code, Hierarchie und Confidence
`attributes.mandatory`	Pflicht-Attribute fuer den erkannten GPC Brick
`attributes.optional`	Optionale Attribute (empfohlen fuer hoeheren DQX Score)
`dqx`	Qualitaets-Check: Score (0-100), Errors und Warnings*
`metadata`	Credit-Verbrauch, Verarbeitungszeit, Modell-Version

*Der DQX-Score ist enrichas Qualitaetsindikator basierend auf einer Teilmenge offizieller GDSN-Validierungsregeln. Er ist kein offizielles GS1-DQX-Assessment.

Attribut-Quellen

Jedes Attribut hat ein source-Feld:

Source	Bedeutung
`input_mapped`	Direkt aus deinen Eingabedaten abgeleitet
`reference_data`	Aus GS1-Referenzdaten (Code-Listen)
`ai_inferred`	Von KI erschlossen — pruefe Confidence

Naechste Schritte

Credits kaufen — Pay-as-you-go, ab 100 Credits
API Reference — Alle Endpoints, Felder und Error Codes
Playground — Interaktiv ausprobieren ohne API Key