Geliver API ile çalışmak için panelimiz üzerinden oluşturacağınız Bearer token'lar ile yetkilendirme sağlamanız gerekmektedir. Bu token'larını aşağıdaki görsellerde belirttiğimiz şekilde edinebilirsiniz.
Authentication (kullanıcı belirtme) ve authorization (yetkilendirme), her istekteki Authorization header’ından alınır. Buraya paneldeki API Tokenları bölümünden alacağınız token’ı önünde Bearer yazacak şekilde ekleyin.
Token oluşturma
- Geliver paneli üzerinden API Token oluşturup REST API’ımız ile yapacağınız işlemlerinizde kullanabilirsiniz. Bunu yapabilmek için sol taraftaki menünün alt kısmında yer alan Ayarlar sayfasından API Tokenları bölümüne gitmelisiniz.
2. Geliştirici Araçları grubundaki API Tokenları kartı seçilir.
3. Yeni API Token Ekle düğmesi kullanılır.
4. Token'a bir isim verilir. İsimlendirme serbesttir; hangi sistem için kullanıldığının yazılması sonradan yönetimi kolaylaştırır, örneğin "muhasebe-entegrasyonu". Token'ın sadece belirli IP adresleri tarafından erişilebilir olması isteniyorsa gerekli eklemeler yapılır.
5. Oluştur düğmesiyle devam edilir.
Token oluşturulur ve ekranda bir kez gösterilir. Yanındaki kopyalama seçeneğiyle alınıp güvenli bir yere kaydedilmesi gerekmektedir.
İlgili panel sayfası: API Tokenları
Token tekrar görüntülenemiyorsa
Önemli. Token güvenlik gereği yalnızca oluşturulduğu anda açık hâliyle gösterilir. Sonrasında listede maskeli olarak görünür ve açık hâli bir daha gösterilmez.
Token kaybedildiyse:
-
Yeni bir token oluşturulur.
-
Oluşturulduğu anda ekranda çıkan kopyalama seçeneğiyle kaydedilir.
-
Eski token'ı kullanan bir yer kalmadıysa silinebilir.
Güvenlik önerileri
-
Her entegrasyon için ayrı token oluşturulması önerilir; birisiyle problem yaşandığında yalnızca o iptal edilir.
-
Token istemci tarafında, yani tarayıcı veya mobil uygulama kodunda tutulmamalıdır.
-
Bir eklenti kaldırıldığında ilgili token silinmelidir.
-
Token, ekran görüntülerine veya e-postalara eklenmemelidir.
Token nerelerde kullanılır?
-
REST API çağrıları — Açıklama: Gönderi oluşturma, teklif alma, etiket satın alma, takip sorgulama
-
Bazı mağaza entegrasyonları — Açıklama: Platformun paneline girilerek bağlantı kurulur
-
Kolay Sipariş gibi platformlar — Açıklama: Token platformun destek birimine iletilir
İlgili makaleler
-
Webhook kurma ve sorun giderme
-
Gönderici ve iade adres kimliği
-
Mağaza entegrasyonlarına genel bakış
---
Bu makalede yanıtını bulamadığınız bir konu olursa panelinizden destek talebi oluşturabilirsiniz.