API referansı
Mevcut panel ve mağaza uçlarını kapsamlarıyla birlikte incele.
01Bu referansın kapsamı#
Bu sayfa mevcut uygulamanın panel ve mağaza içi HTTP sözleşmelerini açıklar. Uçlar sürümlenmiş, herkese açık bir geliştirici API ürünü olarak sunulmuyor. Bağımsız ERP, mobil uygulama veya sunucudan sunucuya entegrasyon için erişim yöntemini önce destek ekibiyle netleştir.
02Panel uçları#
| Yöntem | Yol | Kullanım |
|---|---|---|
| GET / POST | /api/dashboard/products | Katalog listeleme / ürün oluşturma |
| GET | /api/dashboard/products?csv=1 | Katalog dışa aktarma |
| POST | /api/dashboard/products/ice-aktar | CSV önizleme veya uygulama |
| GET / PUT | /api/dashboard/theme | Tema listesi ve ayarlar |
| GET / PUT | /api/dashboard/layout | Blok kütüphanesi ve sayfa düzeni |
| GET / POST | /api/dashboard/theme/upload | Özel tema listesi / ZIP yükleme |
| GET / PUT | /api/dashboard/payment | Maskeli ödeme durumu / yapılandırma |
| GET / PUT / POST | /api/dashboard/domain | Domain durumu / kayıt / doğrulama |
| GET / POST | /api/dashboard/ai | Görev-kota keşfi / içerik üretimi |
| POST | /api/upload | file alanıyla görsel yükleme |
03Mağaza uçları#
Ürün slug sorgusunda bulunamayan veya aktif olmayan ürünler sonuçtan çıkarılır. ids verilirse KDV sorgusu çalışır; bunu tam katalog cevabı bekleyen kodla karıştırma.
| Yöntem | Yol | Davranış |
|---|---|---|
| GET | /api/store/urunler?slugs=... | En fazla 12 slug için aktif ürün bilgileri |
| GET | /api/store/urunler?ids=... | En fazla 60 ürün kimliği için kdvOranlari eşlemesi |
| GET | /api/store/checkout | Kullanılabilir ödeme yöntemleri ve kargo kuralları |
| POST | /api/store/checkout | Sipariş oluşturma; fiyat/stok doğrulaması sunucuda |
const params = new URLSearchParams({ slugs: 'keten-gomlek,pamuk-tisort' });const response = await fetch(`/api/store/urunler?${params}`);if (!response.ok) throw new Error(`HTTP ${response.status}`);const { products } = await response.json();// Yalnızca bulunan ve aktif ürünler döner.// Fiyat, stok ve varyant bilgisini güncel yanıttan kullan.04Hata yanıtını işle#
Uçların çoğunda hata mesajı error alanındadır. Önce HTTP durumunu kontrol et; başarılı cevapları hata gövdesi gibi, HTML yönlendirmelerini JSON gibi ayrıştırma. Finansal yazma işlemlerini ağ hatasında körlemesine tekrar gönderme.
{ "error": "Yetkisiz"}Hedefini ve takıldığın adımı anlat; birlikte ilerleyelim.