Documentazione API
Integra DPP-Tool nei tuoi sistemi esistenti.
L'accesso alle API richiede un piano Pro o superiore.
Vedi i pianiAutenticazione
Includi la tua chiave API nell'intestazione Authorization:
Authorization: Bearer YOUR_API_KEY
Endpoint
GET /api/products
Elenca tutti i tuoi prodotti con impaginazione.
Risposta
{
"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
Crea un nuovo prodotto e genera automaticamente il suo passaporto.
Corpo della richiesta
{
"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
Ottieni i dati del passaporto in formato JSON (pubblico, nessuna autenticazione richiesta).
GET /api/qrcode?slug={slug}&size=300
Genera un codice QR per un passaporto (pubblico, nessuna autenticazione richiesta).
Restituisce un'immagine PNG.
GET /api/export?slug={slug}&format={json|csv}
Esporta i dati del passaporto in vari formati.
Limiti di frequenza
| Piano | Richieste / ora |
|---|---|
| Free | 10 |
| Pro / Business | 100 |
Codici di errore
| Codice | Significato |
|---|---|
| 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 |