Dokumentacja API
Zintegruj DPP-Tool ze swoimi istniejącymi systemami.
Dostęp do API wymaga planu Pro lub wyższego.
Zobacz planyUwierzytelnianie
Dołącz klucz API w nagłówku Authorization:
Authorization: Bearer YOUR_API_KEY
Punkty końcowe
GET /api/products
Lista wszystkich produktów z paginacją.
Odpowiedź
{
"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
Utwórz nowy produkt i automatycznie wygeneruj jego paszport.
Treść żądania
{
"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
Pobierz dane paszportu w formacie JSON (publiczne, bez wymaganego uwierzytelnienia).
GET /api/qrcode?slug={slug}&size=300
Wygeneruj kod QR dla paszportu (publiczne, bez wymaganego uwierzytelnienia).
Zwraca obraz PNG.
GET /api/export?slug={slug}&format={json|csv}
Eksportuj dane paszportu w różnych formatach.
Limity żądań
| Plan | Żądania / godzinę |
|---|---|
| Free | 10 |
| Pro / Business | 100 |
Kody błędów
| Kod | Znaczenie |
|---|---|
| 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 |