Mağazanızı Diğer Sistemlere Bağlayın 🔌
Mağazanız nadiren tek başına çalışır. Ürünler bir tedarikçiden gelir, stok bir depo sisteminde durur, siparişler bir muhasebe ya da teslimat aracına gider. Mağaza API'si bu sistemlerin mağazanızla doğrudan konuşmasını sağlar, böylece kimsenin verileri elle kopyalaması gerekmez.
Bir geliştirici, bir ajans ya da bir yapay zeka kodlama aracı bunu şunlar için kullanabilir:
- Toplu ürün eklemek: seçenekleriyle (renk, beden vb.), seçenek başına fiyat ve stokla ve fotoğraflarıyla
- Stoku senkronize tutmak: bir tedarikçiyle ya da depoyla, birkaç dakikada bir
- Yeni siparişleri okumak: geldikçe başka bir sisteme iletmek
- Siparişleri ilerletmek: kabul edildi, kargoda, teslim edildi, iptal edildi
- Kategorileri yönetmek
API Nerede?
Her mağazanın kendi adresinde kendi API'si vardır:
https://your-store.trinavo.com/api/v1veya- Kendi alan adınızı kullanıyorsanız
https://www.your-domain.com/api/v1
Merkezi bir api.trinavo.com yoktur ve aranacak bir mağaza kimliği de yoktur: mağazanızı seçen şey mağazanızın adresidir.
Erişim Alma
- Yönetim panelinizde Kullanıcı Yönetimi → API Jetonları'nı açın ve bir jeton oluşturun.
- Neler yapabileceğini seçin: ürünleri, kategorileri ve siparişleri okuma ya da yazma, veya her şey.
- Jetonu kopyalayın (yalnızca bir kez gösterilir) ve geliştiriciye ya da araca verin. Her istek jetonu
Authorization: Bearer <token>olarak taşır.
Her jetonu aynı ekrandan istediğiniz zaman görebilir, yeniden oluşturabilir ya da iptal edebilirsiniz.
Geliştiriciler ve Yapay Zeka Araçları İçin Hazırlanmış Dokümantasyon
Her mağaza dokümantasyonunu kendi adresinde yayınlar:
- Etkileşimli başvuru kılavuzu:
/api/documentation - OpenAPI şeması:
/api/openapi.yaml(ayrıca/api/openapi.json), Postman'e, bir API istemcisine ya da özel bir GPT'ye aktarmaya hazır - Yapay zeka asistanları için rehber:
/llms-full.txt, çalışan örneklerle; ChatGPT, Claude ya da Gemini gibi araçlar tahmin etmek yerine doğru çağrılar yazar
Canlı bir örneği demo mağazamızda görebilirsiniz: demo.trinavo.com/api/documentation.
Neleri Kapsar?
| Alan | Neler yapabilirsiniz |
|---|---|
| Ürünler | Listeleme, okuma, oluşturma, güncelleme ve silme; adıyla seçenekler ve varyasyonlar; URL ile fotoğraflar; SKU, barkod, maliyet, ağırlık ve boyut |
| Stok | Bir ürünün ya da her varyasyonun miktarını kimliğe ya da SKU'ya göre ayarlama |
| Kategoriler | Listeleme, okuma, oluşturma, güncelleme ve devre dışı bırakma |
| Siparişler | Siparişleri listeleme ve okuma (düzenli sorgulama için "şu tarihten beri değişen" filtresiyle), sipariş verme, sipariş durumunu değiştirme |
API üzerinden yapılan değişiklikler yönetim panelinizdekiyle tamamen aynı davranır: stok hareketleri kaydedilir ve bir siparişin durumunu değiştirmek, Durumu Değiştir düğmesinin yaptığı gibi stoku düşer, iadeleri işler ve müşteriyi bilgilendirir.
Bilmekte Fayda Var
- Çağrılar canlı mağazanızı değiştirir. Ayrı bir test mağazası yoktur, bu yüzden yeni bir entegrasyonu bu amaçla oluşturulmuş bir ürün üzerinde deneyin.
- Güncellemeler düzenli sorgulama ile gelir. Henüz webhook yoktur; bir entegrasyon, son çalışmasından beri değişen siparişleri birkaç dakikada bir ister.
- Sınırlar: jeton başına dakikada 60 istek.
- Jetonları bir sunucuda tutun. Herkese açık bir web sayfasına konan jetonu her ziyaretçi okuyabilir.
Sadece Sormayı mı Tercih Ediyorsunuz?
İstediğiniz bir entegrasyon değil de satışlarınız, stokunuz ve kârınız hakkında cevaplarsa API'ye hiç ihtiyacınız yok: ChatGPT'yi ya da Claude'u mağazanıza bağlayın ve sade bir dille sorun.