Dla Developerów

Dokumentacja API

Potężne RESTful API do zarządzania cyfrowymi paszportami produktów. Pełna kontrola programistyczna nad Twoimi danymi.

Szybki Start

Przykład żądania API 
curl -X GET "https://api.cyfrowazgodnosc.pl/v1/products" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
REST

RESTful API zgodne z najlepszymi praktykami

JSON

Odpowiedzi w formacie JSON

OAuth 2.0

Bezpieczna autoryzacja

Główne Endpointy

Produkty

Zarządzanie cyfrowymi paszportami produktów

/v1/products
GET /v1/products
Lista wszystkich produktów
GET /v1/products/{id}
Szczegóły produktu
POST /v1/products
Utwórz nowy DPP
PUT /v1/products/{id}
Aktualizuj DPP
DELETE /v1/products/{id}
Usuń DPP

Materiały

Zarządzanie bazą materiałów i komponentów

/v1/materials
GET /v1/materials
Lista materiałów
POST /v1/materials
Dodaj materiał

Ślad Węglowy

Kalkulacja i raportowanie emisji CO2

/v1/carbon
GET /v1/carbon/{product_id}
Raport śladu węglowego
POST /v1/carbon/calculate
Oblicz emisje

Zgodność

Sprawdzanie zgodności z regulacjami UE

/v1/compliance
GET /v1/compliance/check/{product_id}
Sprawdź zgodność
GET /v1/compliance/report
Raport zgodności

Autoryzacja

OAuth 2.0 Bearer Token

Wszystkie żądania API wymagają klucza autoryzacji w nagłówku HTTP. 

Authorization: Bearer YOUR_API_KEY

Jak uzyskać klucz API?

  1. Zaloguj się do DPP Manager
  2. Przejdź do Ustawienia → API
  3. Wygeneruj nowy klucz API
  4. Skopiuj i bezpiecznie przechowuj klucz

⚠️ Bezpieczeństwo

  • • Nigdy nie udostępniaj klucza API publicznie
  • • Używaj HTTPS dla wszystkich żądań
  • • Rotuj klucze regularnie
  • • Monitoruj użycie API

Limity Zapytań

1000
żądań / godzinę
Plan Basic
5000
żądań / godzinę
Plan Professional
∞
bez limitu
Plan Enterprise

Rate Limit Headers

Każda odpowiedź API zawiera nagłówki z informacją o limitach:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 842
X-RateLimit-Reset: 1609459200

Kody Błędów

200
OK
Żądanie wykonane pomyślnie
201
Created
Zasób utworzony pomyślnie
400
Bad Request
Nieprawidłowe parametry żądania
401
Unauthorized
Brak lub nieprawidłowy klucz API
404
Not Found
Zasób nie został znaleziony
429
Too Many Requests
Przekroczono limit zapytań
500
Internal Server Error
Błąd po stronie serwera

Gotowy na start?

Zarejestruj się i otrzymaj klucz API w ciągu kilku minut. Zacznij integrować DPP Manager z Twoimi systemami już dziś.

Rozpocznij bezpłatny trial Zobacz integracje
OAuth 2.0
RESTful JSON
OpenAPI Spec