REST API REFERENCE v1.4

Geliştirici API Portalı

DPP Report RESTful API referans kılavuzu. Marka sistemlerinizi, üretim bantlarınızı ve doğrulama noktalarınızı saniyeler içinde entegre edin.

Kimlik Doğrulama

DPP Report API'leri, isteklerin güvenliğini sağlamak için Bearer Token kimlik doğrulama mekanizmasını kullanır. API anahtarlarınızı kurumsal yönetim panelinizden güvenli bir şekilde üretebilirsiniz.

Authorization: Bearer dpp_live_7f92b...a3f

Güvenlik Uyarısı

API anahtarınızı kesinlikle istemci tarafı (client-side) kodlarınızda veya açık GitHub depolarında paylaşmayın. Tüm API istekleri HTTPS üzerinden yapılmalıdır.

Oran Sınırları & SLA

Farklı üyelik seviyelerine göre uygulanan küresel rate limit sınırları aşağıda detaylandırılmıştır. Sınır aşımında HTTP 429 Too Many Requests hatası döner.

Tier Limit Burst Allowance
Standard 1,000 req/min 50 req
Premium Enterprise 10,000 req/min 500 req
GET /v1/verify

Ürün Doğrulama

Belirli bir sertifika kodunu (DPP ID) sorgulayarak ürünün orijinalliğini, sahibini, garanti durumunu ve tüm ekolojik / DPP verilerini döndürür.

Query Parameters

code Required
String (e.g. DPP-ABC-123)
curl -X GET "https://api.dpp.report/v1/verify?code=DPP-ABC-123" \
  -H "Authorization: Bearer dpp_live_7f92b...a3f"
POST /v1/transfer

Sahiplik Transferini Başlat

Mevcut bir sertifika sahibinden yeni bir alıcıya sahiplik devri başlatır. İşlem sonrasında alıcıya onay linki içeren SMS/E-posta gönderilir.

JSON Body Parameters

code Required
String (DPP ID)
recipient_email Required
String (Valid Email)
curl -X POST "https://api.dpp.report/v1/transfer" \
  -H "Authorization: Bearer dpp_live_7f92b...a3f" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "DPP-ABC-123",
    "recipient_email": "newowner@mail.com"
  }'
POST /v1/products

Yeni Ürün Kaydı (Toplu)

Markanız için ERP sisteminizden toplu olarak yeni ürünleri ve ekolojik / ESPR detaylarını kaydeder.

JSON Body Parameters

name Required
String (e.g. Leather Jacket)
gtin Optional
String (8-14 Digits)
curl -X POST "https://api.dpp.report/v1/products" \
  -H "Authorization: Bearer dpp_live_7f92b...a3f" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Eco Series Chronograph",
    "model": "CH-900",
    "gtin": "8681234567890",
    "recycled_content": 45
  }'