Przejdź do głównej treści

Dostęp do API wymaga planu Pro lub wyższego.

Zobacz plany

Uwierzytelnianie

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ę
Free10
Pro / Business100

Kody błędów

KodZnaczenie
400Bad Request
401Unauthorized — invalid or missing API key
403Forbidden — plan does not include API access
404Not Found
429Rate Limit Exceeded
500Internal Server Error