API Referans

GET /api/products?limit=20
X-API-Client: 59cbbab1-867a-4020-be4a-da534a3c4aca
X-API-Key: 6f85f588f9...

curl "https://api.eronta.com/api/products?limit=20" \
  -H "X-API-Client: <clientId>" \
  -H "X-API-Key: <clientSecret>"

Panel → Özel Uygulamalar → Yeni Uygulama Ekle ile oluşturulan her uygulama için bir clientId ve clientSecret üretilir. clientSecret yalnızca bir kere gösterilir; kaybedilirse yeniden oluşturulmalıdır.

{
  "ok": true,
  "products": [ ... ],
  "total": 9954
}

{ "ok": false, "error": "Oturum gerekli" }

{ "ok": true, "total": 1240, "products": [{ "id": "MP-001", "barcode": "8691234567890", "title": "Ürün Başlığı", "marketplace": "trendyol", "price": 299.90, "stock": 42, "status": "active" }] }

{ "ok": true, "product": { "id": "MP-001", "barcode": "8691234567890", "title": "Ürün Başlığı", "marketplace": "trendyol", "price": 299.90, "listPrice": 349.90, "stock": 42, "brand": "Marka", "status": "active" } }

POST /api/products
Content-Type: application/json

{ "title": "Pamuklu T-Shirt Siyah L", "barcode": "8690000112233", "sku": "TSH-BLK-L", "sellPrice": 249.90, "listPrice": 299.90, "stockCount": 50, "brand": "MyBrand", "category": "Giyim > T-Shirt", "images": ["https://cdn.example.com/tshirt.jpg"], "attributesKV": [{"key":"Renk","value":"Siyah"},{"key":"Beden","value":"L"}] }

{ "ok": true, "product": { "id": "f9a3c1d2-...", "source": "eronta", "title": "Pamuklu T-Shirt Siyah L", "barcode": "8690000112233", "sellPrice": 249.90, "stockCount": 50, "createdAt": 1743000000000 } }

409 Conflict — Aynı barkodla ürün zaten varsa: {"ok":false,"error":"Bu barcode ile zaten bir ürün mevcut.","code":"BARCODE_CONFLICT"}

Yalnızca gönderilen alanlar güncellenir. Stok veya fiyat değiştiğinde Trendyol / Hepsiburada'ya otomatik push tetiklenir.

PUT /api/products/f9a3c1d2-...
Content-Type: application/json

{ "sellPrice": 279.90, "discountPrice": 259.90, "stockCount": 42, "isActive": true }

{ "ok": true, "product": { "id": "f9a3c1d2-...", "sellPrice": 279.90, "stockCount": 42 } }

PUT /api/products/:id endpoint'inin stok odaklı kullanımı. Yalnızca stockCount gönderildiğinde pazaryeri stok push'u otomatik tetiklenir.

PUT /api/products/f9a3c1d2-...
{ "stockCount": 100 }

{ "ok": true, "product": { "id": "f9a3c1d2-...", "stockCount": 100, "updatedAt": 1743120000000 } }

Toplu stok için: POST /api/products/import veya fiyat listeleri üzerinden toplu güncelleme yapabilirsiniz.

PUT /api/products/f9a3c1d2-...
{ "sellPrice": 349.90, "discountPrice": 299.90 }

PUT /api/products/f9a3c1d2-...
{ "sellPrice": 349.90, "priceLists": [{ "priceListId": "pl-001", "salePrice": 349.90, "discountedPrice": 299.90 }] }

{ "ok": true, "product": { "id": "f9a3c1d2-...", "sellPrice": 349.90 } }

En fazla 20 görsel, toplam 20 MB. Formatlar: jpg, png, webp.

curl -X POST https://api.eronta.com/api/products/f9a3c1d2-.../images \
  -H "X-API-Client: <clientId>" -H "X-API-Key: <secret>" \
  -F "images=@/path/to/photo1.jpg" -F "images=@/path/to/photo2.jpg"

{ "ok": true, "added": 2, "images": ["https://api.eronta.com/api/uploads/abc123.jpg","https://api.eronta.com/api/uploads/def456.jpg"] }

{ "ok": true, "deleted": "f9a3c1d2-..." }

multipart/form-data ile .xlsx / .csv dosyası gönderin.

{ "ok": true, "imported": 145, "updated": 32, "skipped": 3, "errors": [] }

{ "source": "trendyol", "startDate": "2026-03-01T00:00:00Z", "endDate": "2026-03-28T23:59:59Z", "page": 1, "limit": 25 }

{ "ok": true, "total": 318, "orders": [{ "id": "12345678", "source": "trendyol", "status": "Delivered", "customerName": "Ahmet Y.", "totalPrice": 459.90, "currency": "TRY", "createdAt": "2026-03-20T14:32:00Z" }] }

source: trendyol | hepsiburada | ikas

{
  "ok": true,
  "order": {
    "id": "12345678", "source": "trendyol", "status": "Delivered",
    "customerName": "Ahmet Yılmaz",
    "shippingAddress": { "fullName": "Ahmet Yılmaz", "address": "Atatürk Cad. No:5", "city": "İstanbul", "district": "Kadıköy" },
    "lines": [{ "barcode": "8690000112233", "productName": "Pamuklu T-Shirt", "quantity": 2, "amount": 249.90 }],
    "totalPrice": 499.80, "cargoTrackingNumber": "TR123456789", "cargoCompany": "Yurtiçi Kargo"
  }
}

{ "ok": true, "today": { "orderCount": 24, "revenue": 8740.50 }, "last7days": { "orderCount": 187, "revenue": 68450.75 }, "last30days": { "orderCount": 823, "revenue": 298120.40 }, "bySource": { "trendyol": { "count": 512, "revenue": 183000 }, "hepsiburada": { "count": 311, "revenue": 115120 } } }

{ "ok": true, "invoiceNo": "EAR-2026-00124", "invoiceUrl": "https://..." }

Yanıt olarak dosya stream döner (application/octet-stream).

{ "ok": true, "totalElements": 14, "questions": [{ "id": "q-98765", "text": "Bu ürün L beden büyük mü kesiliyor?", "status": "WAITING_FOR_ANSWER", "barcode": "8690000112233", "productName": "Pamuklu T-Shirt Siyah L", "platform": "trendyol" }] }

Eronta AI, ürün açıklaması ve özellikleri göz önünde bulundurarak doğal dilde cevap taslağı üretir.

POST /api/questions/generate
{ "question": "Bu ürün L beden büyük mü kesiliyor?", "barcode": "8690000112233" }

{ "ok": true, "answer": "Merhaba! Ürünümüz standart kesimde olmakla birlikte rahat bir kullanım için bir beden büyük almanızı öneririz." }

Not: AI paketi gerektiren bir özelliktir. Paketsiz hesaplarda 403 FEATURE_DISABLED döner.

{ "ok": true, "message": "Cevap gönderildi." }

{ "ok": true, "storePrompt": "Mağazamız hafta içi 09:00-18:00 açıktır. Kargo 1-3 iş günü.", "autoMode": "generate", "lastAutoRunAt": 1743100000000 }

autoMode: off — devre dışı | generate — AI taslak, onay bekler | auto — otomatik yanıtla

POST /api/questions/settings
{ "storePrompt": "Kargo 1-3 iş günü. İadeler 14 gün içinde.", "autoMode": "generate" }

{ "ok": true, "priceLists": [{ "id": 3, "name": "Trendyol Yazlık", "currency": "TRY", "itemCount": 248, "createdAt": "2026-01-15T08:00:00Z" }] }

{ "ok": true, "id": 5, "name": "Yaz Kampanyası" }

{ "ok": true }

Excel dosyası (application/octet-stream) döner.

multipart/form-data ile file alanında XLS gönderilir.

{ "ok": true, "imported": 248, "skipped": 2 }

{ "ok": true, "products": [{ "barcode": "8691234567890", "title": "Ürün Başlığı", "marketplace": "trendyol", "myPrice": 299.90, "buyboxPrice": 279.90, "hasBuybox": false }] }

{ "ok": true, "suggestedPrice": 274.90, "minAllowedPrice": 267.50, "profitMargin": 0.14 }

{ "ok": true, "settings": { "autoSync": true, "autoSyncInterval": 30, "minMarginPercent": 10 } }

{ "ok": true, "conversationId": "conv_xkq82", "reply": "Bu hafta en çok satan 5 ürününüz..." }

{ "ok": true, "insights": [{ "id": "ins_m9k3", "type": "low_stock", "severity": "warning", "title": "8 ürününüzde stok kritik", "isRead": false }] }

{ "ok": true, "recommendations": [{ "id": "rec_p2a1", "type": "price_adjustment", "title": "Buybox kazanmak için fiyat düşürün", "impact": "high" }] }

{ "ok": true, "settings": { "stockBuffer": 2, "currency": "TRY", "timezone": "Europe/Istanbul" } }

{ "ok": true, "users": [{ "id": 42, "email": "kullanici@firma.com", "fullName": "Ad Soyad", "role": "admin", "isActive": true }] }