API-Dokumentation
Integrieren Sie DPP-Tool in Ihre bestehenden Systeme.
API-Zugriff erfordert einen Pro-Plan oder höher.
Pläne ansehenAuthentifizierung
Fügen Sie Ihren API-Schlüssel in den Authorization-Header ein:
Authorization: Bearer YOUR_API_KEY
Endpunkte
GET /api/products
Listen Sie alle Ihre Produkte mit Paginierung auf.
Antwort
{
"products": [
{
"id": "abc123",
"name": "EcoCharge Pro 5000",
"sector": "batteries",
"gtin": "4006381333931",
"created_at": "2026-01-15T10:30:00Z"
}
],
"total": 1,
"page": 1
}
POST /api/products
Erstellen Sie ein neues Produkt und generieren Sie automatisch seinen Pass.
Anfrage-Body
{
"name": "EcoCharge Pro 5000",
"sector": "batteries",
"manufacturer_name": "GreenTech GmbH",
"gtin": "4006381333931",
"carbon_footprint": 12.5,
"recycled_content": 65,
"energy_class": "A+"
}
GET /api/passport?slug={slug}&format=json
Abrufen von Pass-Daten im JSON-Format (öffentlich, keine Authentifizierung erforderlich).
GET /api/qrcode?slug={slug}&size=300
Generieren Sie einen QR-Code für einen Pass (öffentlich, keine Authentifizierung erforderlich).
Gibt ein PNG-Bild zurück.
GET /api/export?slug={slug}&format={json|csv}
Exportieren Sie Pass-Daten in verschiedenen Formaten.
Ratenlimits
| Plan | Anfragen / Stunde |
|---|---|
| Free | 10 |
| Pro / Business | 100 |
Fehlercodes
| Code | Bedeutung |
|---|---|
| 400 | Bad Request |
| 401 | Unauthorized — invalid or missing API key |
| 403 | Forbidden — plan does not include API access |
| 404 | Not Found |
| 429 | Rate Limit Exceeded |
| 500 | Internal Server Error |