Başarılı Listeleme Ne Anlama Gelir?
Bir ikas özel uygulamasının ürünleri listelemesi, aynı ürünleri düzenleme yetkisinin de bulunduğunu göstermez. Özel uygulama izinlerinde veri grupları için okuma ve düzenleme kapsamları ayrı belirlenir. Entegrasyon değerlendirmesi yapılacak gerçek işleme göre yürütülmelidir.
Örneğin varsayımsal bir stok raporu uygulaması ürünleri okuyabilir fakat fiyat değiştirmesi gerekmeyebilir. Raporun çalışmasını gerekçe göstererek bütün alanlara yazma izni vermek gereksiz bir genişleme yaratır. Önce uygulamanın hangi kaydı, hangi iş amacıyla güncelleyeceği netleştirilir. Beklenen işlem kapsamı belirlenmeden izinleri deneme yoluyla artırmak doğru bir teşhis değildir.
Veri Grubuna Göre Yetki Kapsamı
ikas özel uygulama ekranında ürün, sipariş, müşteri ve envanter gibi veri gruplarına ait izinler tanımlanabilir. Bir alandaki yazma izni bütün veriler üzerinde sınırsız düzenleme hakkı olarak yorumlanmamalıdır.
AdPix’in önerdiği kapsam tablosunda her iş için okunan veri ve değiştirilen veri ayrılır. Örneğin muhasebe aktarımı sipariş bilgisine ihtiyaç duyabilir; ürün açıklamasını değiştirmek aynı işin zorunlu parçası olmayabilir. Bu tablo hem entegrasyon geliştiricisinin beklentisini hem mağaza yöneticisinin verdiği erişimi anlaşılır hâle getirir. Yetki değişikliği sonrasında yalnızca hedeflenen işlemin çalıştığı doğrulanır.
Özel Uygulamada Okuma ve Düzenleme İzinleri
Resmî ikas destek görseli, ürünler ve siparişler gibi veri gruplarında görüntüleme ile düzenleme seçeneklerinin ayrı tanımlandığını gösterir. Görseldeki seçimler örnektir; uygulamanıza verilecek izinler gerçek iş kapsamına göre belirlenmelidir.
Erişim Tokenının Süresi
ikas özel uygulama doğrulamasında client_id ve client_secret kullanılarak erişim tokenı alınır. Yanıttaki expires_in alanı saniye cinsinden süreyi belirtir. Süresi dolan token için yenisi alınmalıdır; eski tokenın kalıcı bir parola olduğu varsayılmamalıdır.
Bir bağlantının ilk kurulduğunda çalışıp daha sonra bütün isteklerde hata vermesi, yalnızca ürün yetkisiyle açıklanmayabilir. İnceleme notunda son başarılı isteğin zamanı ve hata türü bulunmalıdır. Gerçek token değeri loglara veya herkese açık ekran görüntülerine yazılmaz. Destek ekibine sonuç kodu ve maskelenmiş istek bilgisi iletilmesi çoğu teşhis için daha uygundur.
Kimlik Doğrulama ve Veri İstekleri
Resmî geliştirici belgesi token alma adresi ile Admin GraphQL API adresinin farklı olduğunu belirtir. Token alındıktan sonra veri isteğinde Bearer biçiminde kullanılır. Doğru anahtarı yanlış adrese göndermek, izinleri artırarak giderilecek bir durum değildir.
Örnek bir teknik devir notunda kullanılan uç noktanın amacı, işlem türü ve beklenen yanıt bulunmalıdır. Tam anahtar veya müşteri verisi paylaşılması gerekmez. Böylece bağlantıyı kuran ekip ile işlemi kullanan ekip aynı sorunu farklı sistemlerde aramaz. Önce kimlik doğrulamanın, sonra ilgili veri işleminin sonucu ayrı kaydedilir.
Sınırlı Bir Kayıtla Sonuç Kontrolü
Yetki veya token sorunu giderildikten sonra binlerce kayda birden güncelleme göndermek yerine sınırlı bir örnek kayıt üzerinde beklenen alan doğrulanabilir. Bu öneri, mağazanın iş verisini koruyan kontrollü bir çalışma biçimidir.
Varsayımsal bir stok bağlantısında bir varyantın beklenen adede geldiği, diğer varyantların değişmediği incelenir. API yanıtının başarılı görünmesi ile paneldeki sonucun doğru olması birlikte değerlendirilmelidir. Test için seçilen kaydın öncesi ve sonrası saklanır; kapsam dışı alan değişikliği görülürse toplu işleme geçilmeden istek içeriği düzeltilir.
Bu Yazıdaki Terimler 1 Kavram
Kısa açıklamaları burada okuyabilir, ayrıntılar için sözlüğe geçebilirsiniz.
- Ürün Açıklaması
- Ürün açıklaması, ürünün özelliklerini, faydalarını, kullanım alanını ve satın alma gerekçesini anlatan metindir.
Bu Konuda Nasıl Destek Oluyoruz?
AdPix’in bu alandaki hizmet kapsamını ve çalışma sürecini inceleyin.
ikas