REST API v1

REST API Dokumentation

Automatisieren Sie Ihren Batteriepass-Workflow. Produkte per REST API erstellen, aktualisieren, veröffentlichen und exportieren. Die Pass-Abruf-Endpunkte sind an den Methoden und REST-Vorgaben der EN 18222:2026 ausgerichtet; die vollständige Konformitätsprüfung einschließlich abhängiger Normen ist noch offen.

Authentifizierung

Scale-Plan erforderlich. Schlüssel in Ihren Organisationseinstellungen erstellen.

Authorization: Bearer dpp_live_...

Base URL

120 Anfragen/Minute pro Organisation.

https://app.dpphero.com/api/v1

Quick Example

curl -X POST https://app.dpphero.com/api/v1/products \
  -H "Authorization: Bearer dpp_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "LFP Module 48V",
    "serial_number": "BAT-2025-001",
    "battery_category": "industrial",
    "manufacturing_date": "2025-06-15",
    "battery_mass": 45.5
  }'

Verfügbare Endpoints

Alle Endpoints erfordern einen Bearer Token (API-Schlüssel). Verfügbar im Scale-Tarif.

Produkte

GET/products
POST/products
GET/products/{id}
PATCH/products/{id}
DELETE/products/{id}
POST/products/{id}/image
DELETE/products/{id}/image
POST/products/{id}/files

Batteriezustand

Dynamische BMS-Daten wie Ladezustand, Zyklenanzahl und Kapazitätsverlust per API aktualisieren.

GET/products/{id}/condition
PATCH/products/{id}/condition

Massen-Import

POST/products/bulk

Export

GET/products/{id}/export/json
GET/products/{id}/export/gefeg-json
GET/products/{id}/export/pdf
POST/products/{id}/preprint-qr
GET/products/{id}/export/qr

Organisation

GET/organization
GET/facilities
GET/audit-log

Vollständige Dokumentation

Die komplette API-Referenz mit Felddefinitionen, Beispiel-Payloads, Fehlercodes, Auto-Fill-Regeln und dem vollständigen Produkt-Schema steht in Ihrem Dashboard zur Verfügung.

Tarife ansehenEinloggen für Dokumentation