Kimlik bilgileri ve ortamlar#
Visualizer SDK mağaza vitrininiz için ve gerekirse Product Import API için kimlik bilgilerini yapılandırın. Halka açık belgeleri okumak kimlik bilgisi oluşturmaz veya bir mağazaya erişim sağlamaz.
Hangi kimlik bilgisi nereye ait?#
| Entegrasyon | Kimlik Bilgisi | Ait Olduğu Yer |
|---|---|---|
| Mağaza vitrini SDK | Shop ID ve Publishable Key | Mağaza vitrini SDK betik öznitelikleri |
| Product Import API | Client ID ve Client Secret | Arka planınız veya güvenli sunucu tarafı işi |
Bir Publishable Key tarayıcı içindir. Bir Client Secret sunucunuzda kalmalıdır. Bunları asla bir tema, halka açık Markdown, istemci paketi veya destek ekran görüntüsüne yapıştırmayın.
Kimlik bilgilerini edinin ve yapılandırın#
Satıcı Paneli'ni açın, doğru mağazayı seçin ve SDK Entegrasyon ile Ayarlar bölümlerini gözden geçirin. Client ID ve Client Secret için başlangıç talimatlarını izleyin.
Allowed Origins (CORS) yapılandırması#
SDK'i test etmeden veya yayınlamadan önce, doğru mağaza için Panel → Ayarlar sayfasını açın ve Allowed Origins (CORS) bölümünü bulun.
- SDK'i yükleyecek mağaza vitrinlerinin kökenlerini (origin), virgülle ayrılmış olarak girin. Örneğin:
https://example.com, https://www.example.com, https://shop.example.com. - Sayfa yolu, sorgu dizesi veya parça (fragment) olmadan protokol ve ana bilgisayar adını, uygun olduğunda da portu kullanın. SDK'ı orada test ediyorsanız önizleme veya ön üretim (staging) kökeninizi de ekleyin;
http://localhost:3000'i yalnızca bu, gerçek yerel test kökeninizse kullanın. - Kaydet düğmesine tıklayın, ardından mağaza vitrinini yeniden yükleyin ve SDK'yi tekrar test edin.
Müşterilerin ziyaret ettiği gerçek URL'i kontrol edin: https://example.com ve https://www.example.com farklı kökenlerdir. Başarılı bir yerel veya önizleme testi, yayınlanmış kökenin yapılandırıldığı anlamına gelmez.
Örnek değerleri değiştirin#
Örnekler, <SHOP_ID>, <PUBLISHABLE_KEY> ve <YOUR_CLIENT_SECRET> gibi yer tutucular kullanır. Bunları yalnızca hedef ortamda değiştirin. HTML örneklerinde açı ayraçlar < ve > olarak kodlanabilir; bu kodlamayı da içeren yer tutucunun tamamını değiştirin.
SDK ve Ürün İçe Aktarma ortamları#
Tarayıcı, aynı mağazadan Shop ID ve Publishable Key ile https://sdk.ideal.house/sdk.js'i yükler. Product Import API, belgelenmiş sunucu tarafı kimlik doğrulamasıyla https://sdkapi.ideal.house'ü kullanmaya devam eder.
Yukarıda belirtildiği gibi önizleme ve üretim mağaza vitrini kökenlerinizi ayrı ayrı yapılandırın. Yayınlamadan önce hazırlanmış test ürünlerini kullanın, ardından başlatma kontrol listesini tamamlayın.