Uç Nokta Referansı
API, mağazanızın hemen her kaynağı için okuma/yazma uç noktaları sunar. Aşağıda en sık kullanılan kaynak grupları özetlenmiştir.
| Kaynak | Ne için |
|---|---|
| Ürünler / Kategoriler / Markalar | Katalog yönetimi |
| Envanter / Lokasyonlar | Stok senkronizasyonu |
| Siparişler / Taslak Siparişler | Sipariş okuma, durum güncelleme, harici sistemden sipariş oluşturma |
| Müşteriler / Adresler | CRM entegrasyonu |
| İndirimler / Kampanyalar | Programatik kupon/kampanya yönetimi |
| Temalar | Tasarım otomasyonu |
| Medya | Görsel yükleme |
| İçerik (Sayfa/Blog) | İçerik senkronizasyonu |
| Ödeme Sağlayıcı Ayarları | Sağlayıcı kimlik bilgisi yazma (hassas kapsam) |
| Webhooklar | Olay bildirimleri |
Tam ve makine-okunur referans
Her uç noktanın tam parametre listesi, hata kodları ve örnek istekleri için makine-okunur OpenAPI dokümanına bakabilirsiniz:
GET https://app.rgsyazilim.net/api/admin/{versiyon}/openapi.json
Bu uç nokta kimlik doğrulama gerektirmez, geliştirme araçlarınıza (Postman, kod üretici vb.) doğrudan import edebilirsiniz.
Sayfalama, hata kodları ve sınırlar
Liste uç noktaları imleç tabanlı (cursor) sayfalama kullanır. Her API anahtarının bir istek bütçesi vardır — bütçe aşıldığında 429 hata kodu döner. Para/sipariş/iade gibi kritik işlemlerde çift işlemi önlemek için Idempotency-Key başlığının kullanılması önerilir.