API Dokumentation REST API für Produktdaten
Greifen Sie programmatisch auf Digital Product Passport Daten zu. Unsere REST API liefert strukturierte JSON-Daten.
Übersicht
Base URL
https://openproductdata.fabx.dev/api/v1
Format
JSON (UTF-8)
Authentifizierung
Nicht erforderlich (Public API)
Rate Limits
Die API ist auf 60 Anfragen pro Minute pro IP-Adresse limitiert.
Bei Überschreitung erhalten Sie einen 429 Too Many Requests Response mit einem Retry-After Header.
/api/v1/public/products/{slug}
Gibt alle Daten eines veröffentlichten Produkts zurück, inklusive Materialien, Zertifikate, Nachhaltigkeit und Herkunft.
curl https://openproductdata.fabx.dev/api/v1/public/products/example-product{
"product": {
"name": "Bio-Baumwoll T-Shirt",
"slug": "bio-baumwoll-t-shirt",
"brand": "EcoWear",
"model": "Classic",
"sku": "EW-TS-001",
"gtin": "4012345678901",
"description": "Nachhaltiges T-Shirt aus 100% Bio-Baumwolle",
"category": "Textilien",
"image": "https://openproductdata.fabx.dev/uploads/1/products/abc123.jpg",
"manufacturer": "EcoWear GmbH",
"url": "https://openproductdata.fabx.dev/p/bio-baumwoll-t-shirt",
"materials": [
{
"name": "Bio-Baumwolle",
"percentage": "95.00",
"recyclable": 1,
"recycled_content": "0.00",
"origin_country": "IN",
"certification": "GOTS"
}
],
"certificates": [...],
"sustainability": {
"carbon_footprint_kg": "3.20",
"energy_rating": "A",
"recyclability_percentage": "85.00",
"repair_score": 6
},
"origin": {
"manufactured_in": "PT",
"manufacturer_name": "EcoWear GmbH"
}
}
}Fehler-Responses
404 Not Found
Produkt nicht gefunden oder nicht veröffentlicht.
429 Too Many Requests
Rate Limit überschritten.
/api/v1/public/search
Durchsucht veröffentlichte Produkte nach Name, Marke oder Kategorie.
Query-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
q |
string | Suchbegriff (min. 2 Zeichen, Pflicht) |
curl "https://openproductdata.fabx.dev/api/v1/public/search?q=baumwolle"{
"products": [
{
"slug": "bio-baumwoll-t-shirt",
"name": "Bio-Baumwoll T-Shirt",
"brand": "EcoWear",
"category": "Textilien",
"image_path": "/uploads/1/products/abc123.jpg",
"org_name": "EcoWear GmbH"
}
],
"count": 1
}/p/{slug}/json
Vereinfachter Endpunkt für maschinenlesbare Produktdaten. Ideal für die Integration in andere Systeme.
curl https://openproductdata.fabx.dev/p/bio-baumwoll-t-shirt/jsonCORS & Integration
Alle API-Endpunkte senden den Header Access-Control-Allow-Origin: *, sodass Anfragen von beliebigen Domains möglich sind.
Die Responses werden als application/json; charset=utf-8 ausgeliefert.