Nova REST API · v1

API Dokümantasyonu

Ürün kataloğunu okuyun, arama yapın, sipariş oluşturun ve analitik olayları gönderin. Yanıtlar UTF-8 JSON biçimindedir.

Kimlik doğrulama

Yönetim → Otomasyon ve Entegrasyonlar bölümünden bir token üretin. Token yalnızca üretildiği anda gösterilir; güvenli bir yerde saklayın.

Authorization: Bearer nv_xxxxxxxxxxxxxxxxx

Yetkiler

catalog:readÜrün, kategori ve arama uçlarıorders:readSipariş listesini okumaorders:writeHavale/kapıda ödeme siparişi oluşturmaanalytics:writeAnalitik olayı gönderme

Katalog

GET/api/v1/productsÜrün listesi

Aktif ve onaylı ürünleri döndürür.

GET/api/v1/products/{id}Ürün detayı

Ürünle birlikte varyant ve galeri görsellerini döndürür.

GET/api/v1/categoriesKategoriler

GET/api/v1/search?q=kulaklık&limit=24Arama

Yapılandırılmış veritabanı, Meilisearch veya Elasticsearch sağlayıcısını kullanır.

curl "https://eticaret.wawbilisim.com/api/v1/products" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

Siparişler

GET/api/v1/orders?limit=50Sipariş listesi

orders:read yetkisi gerekir. Limit 1–200 arasındadır.

POST/api/v1/ordersSipariş oluştur

orders:write yetkisi gerekir. API üzerinden kart verisi kabul edilmez; bank_transfer veya aktif kapıda ödeme kodunu kullanın.

curl -X POST "https://eticaret.wawbilisim.com/api/v1/orders" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ayşe Yılmaz",
    "email": "ayse@example.com",
    "phone": "+905551112233",
    "address": "Örnek Mah. No: 1",
    "city": "İstanbul",
    "district": "Kadıköy",
    "payment_method": "bank_transfer",
    "items": [{"product_id": 12, "variant_id": 0, "quantity": 2}]
  }'

Başarılı yanıt 201 durumuyla order_no, total ve currency alanlarını döndürür. Stok ve fiyat sunucuda yeniden doğrulanır.

Analitik ve deneyler

POST/api/v1/analyticsOlay gönder

{"event":"product_view","properties":{"product_id":12}} gövdesiyle gönderilir; başarılı kabul yanıtı 202'dir.

GET/api/v1/experiments/{key}A/B test varyantı

Ziyaretçi için kararlı varyant ataması döndürür; token gerektirmez.

Hata biçimi

Tüm API hataları aynı temel yapıyı kullanır: {"error":"Açıklama"}.

400 Geçersiz JSON/istek401 Token veya yetki hatası404 Kayıt bulunamadı422 İş kuralı, stok veya ödeme hatası503 Arama sağlayıcısı erişilemiyor

Makine tarafından okunabilir şema

Postman, Insomnia, Swagger UI ve SDK üreticilerine OpenAPI 3.1 JSON dosyasını aktarabilirsiniz.