İçeriğe geç
Yardım
Mağaza ayarları

Mağazamı başka bir uygulamaya veya araca bağlamak için nasıl API anahtarı (erişim belirteci) oluştururum?

Mağazanızı kendi yazılımınıza veya üçüncü taraf bir araca bağlamak için API anahtarı (erişim belirteci, access token) oluşturun: ürün okuma, sipariş okuma ve webhook izinlerini seçin, ne kadar geriye okuyabileceğini sınırlayın, son kullanma tarihi belirleyin, kopyalayın ve iptal edin.

3 dk okuma

Erişim belirteçleri ne işe yarar

Erişim belirteci (API anahtarı olarak da bilinir), kendi yazılımınızın, bir geliştiricinin veya üçüncü taraf bir aracın Storeep API'si üzerinden mağazanızdan veri okumasını sağlar. Her belirtecin kendi izinleri, veri aralığı ve son kullanma tarihi vardır, böylece her araca tam olarak ihtiyacı olanı verebilir ve şifrenizi paylaşmadan istediğiniz zaman kaldırabilirsiniz.

Ayarlar > Erişim belirteçleri bölümünü açın. Belgeleri görüntüle düğmesi uç noktaları, belirtecin nasıl gönderileceğini ve istek sınırlarını içeren API başvuru belgesini açar. Bu sayfayı geliştiricinizle paylaşın.

Bunun yerine Claude veya ChatGPT gibi bir yapay zeka asistanı mı bağlamak istiyorsunuz? Bu, erişim belirteçlerini kullanmaz. Bkz. Yapay zeka asistanı bağlama.

Belirteç oluşturma

Yeni token oluştur düğmesine tıklayın, formu doldurun ve Oluştur düğmesine tıklayın.

  • Token adı: listenizde tanımanız için bir etiket, örneğin "Muhasebe senkronizasyonu". Yalnızca siz görürsünüz.
  • İzinler: en az birini işaretleyin:
    • Ürünleri okuma: ürün listeleri, ayrıntılar, varyantlar ve envanter.
    • Siparişleri okuma: sipariş geçmişi, ayrıntılar, durumlar ve sipariş satırları.
    • Webhookları okuma: webhook yapılandırmalarını ve teslim günlüklerini görüntüleme.
    • Webhookları yönetme: API üzerinden webhook aboneliklerini oluşturma, güncelleme ve silme.
  • Veri erişimi: belirtecin ne kadar geriye okuyabileceği.
    • Son 24 saat: yalnızca son 24 saatte oluşturulan veriler. En güvenli seçenektir, canlı senkronizasyonlar için uygundur.
    • Başlangıç tarihi belirle: yalnızca Veri erişim başlangıç tarihi alanında seçtiğiniz tarihte veya sonrasında oluşturulan veriler.
    • Tüm zamanlar: tarih sınırı olmadan tüm verileriniz.
  • Geçerlilik süresi: Hiçbir zaman sona ermez veya en fazla bir yıl sonrasına kadar bir tarih seçmek için Son kullanma tarihi belirle. Bu tarihten sonra belirteç kendiliğinden çalışmayı durdurur.

Belirtecinizi şimdi kopyalayın

Oluştur düğmesine tıkladıktan sonra pencere, bir kopyalama düğmesiyle birlikte Erişim belirteciniz bilgisini gösterir. Bu belirteç yalnızca bir kez gösterilir. Kopyalayın ve şifre yöneticisi gibi güvenli bir yerde saklayın. Storeep onu tekrar gösteremez. Kaybederseniz belirteci silin ve yenisini oluşturun.

Ona bir şifre gibi davranın. Asla web sitesi koduna, herkese açık depolara, ekran görüntülerine veya sohbet mesajlarına koymayın.

Belirteç listesi

  • Ad, oluşturulduğu tarihle birlikte.
  • İzinler: örneğin Ürün okuma veya Sipariş okuma.
  • Veri erişimi: Son 24 saat, Tüm veriler veya bir tarihten itibaren (Kimden).
  • Geçerlilik süresi: bir tarih veya Hiçbir zaman.
  • Son kullanım: bir aracın belirteci en son ne zaman kullandığı veya Hiçbir zaman.

Mağaza başına en fazla belirteç sayısı vardır. Bu sayıya ulaştığınızda, birini silene kadar Yeni token oluştur düğmesi kaybolur.

Bir belirteci düzenleme

Adını, izinlerini, veri erişimini veya geçerlilik süresini değiştirmek için bir belirtece tıklayın. Belirteç değeri aynı kalır, bu yüzden onu kullanan araç yeni kurallarla çalışmaya devam eder.

Bir belirteci silme

Bir veya daha fazla belirteci işaretleyin ve Tokenları sil seçeneğini seçin ya da bir satırdaki çöp kutusu düğmesini kullanın. Belirteç hemen çalışmayı durdurur ve onu kullanan her araç hata alır.

İpuçları

  • Her araca kendi belirtecini verin, böylece diğerlerini bozmadan birini kaldırabilirsiniz.
  • İşe yarayan en küçük veri aralığını seçin.
  • Serbest çalışanlar ve tek seferlik işler için bir son kullanma tarihi belirleyin.
  • Son kullanım alanında uzun süre Hiçbir zaman gösteren bir belirtece muhtemelen ihtiyaç yoktur. Silin.
  • Sunucunuzun sormasını beklemek yerine Storeep'in sipariş olaylarını sunucunuza göndermesi için webhook'ları kullanın.

Hâlâ yardıma mı ihtiyacınız var?

Bize yazın, size yanıt verelim.

Bizimle iletişime geçin