API kullanımı
API ne işe yarar, nasıl anahtar alınır ve bir anahtarın asla yapamayacakları.
Ne işe yarar
Panelde siparişleriniz, eSIM’leriniz, fiyatlarınız ve mağazanızla yaptığınız her şeyi kendi sistemleriniz de yapabilir. En sık nedenler şunlar: gecelik muhasebe mutabakatı, yüzlerce paketi tek seferde yeniden fiyatlandırmak ve sipariş durumunu destek ekibinizin zaten açık tuttuğu ekrana taşımak.
Scale planında bulunur. Diğer planlarda aşağıdaki bölüm görünmez ve anahtar oluşturulamaz; hesabınızda başka hiçbir şey etkilenmez.
Uç nokta referansı api.esimbit.com/docs/reseller-api adresinde ve yalnızca İngilizce: alan adları ve hata kodları hangi dilde okursanız okuyun İngilizcedir, ve geride kalmış bir çeviri hiç olmamasından kötüdür. API anahtarları ekranında ona bir bağlantı var.
Anahtar almak
Anahtarlar panelde API anahtarları bölümünde durur ve yalnızca hesap sahibi oluşturabilir. Bir anahtar onu oluşturandan uzun yaşar ve geri almanın tek yolu iptal etmektir — faturalama ve hesabı devretmenin de sahibe ait olmasıyla aynı gerekçe.
- Panelde API anahtarları bölümünü açın.
- Anahtara, altı ay sonra hâlâ kullanımda olup olmadığına karar verirken anlayacağınız bir ad verin.
- Yalnızca o entegrasyonun ihtiyaç duyduğu kapsamları işaretleyin. Sonradan kapsam eklenemez; yerine yeni bir anahtar oluşturursunuz.
- Mümkünse bir son kullanma tarihi verin. Süresi olmayan bir anahtar, kimsenin gözden geçirmediği anahtardır.
- Gizli anahtarı kopyalayın. Bir kez gösterilir, bir daha asla.
Anahtarın yalnızca özetini sakladığımız için onu size ikinci kez gösterebilecek bir ekran ya da destek talebi yok. Kaybolursa yenisini oluşturup eskisini iptal edersiniz.
Bir anahtarın asla yapamayacakları
Bazı şeyler panelde, bir insanın arkasında kalır. Bu sonradan doldurulacak bir boşluk değil; kastedilen tam olarak budur.
- Para. İadeler, ödeme başlatma, faturalama portalı ve faturalar.
- İnsanlar. Davetler, rol değişiklikleri, çıkarmalar ve hesabı devretmek.
- Sırlar. Sağlayıcı bağlantısı oluşturmak veya silmek — kendi tedarikçi kimlik bilgilerinizi taşırlar.
- Mağaza silmek; bu, o mağazanın gördüğü bütün siparişleri de götürür.
- Yeni anahtar oluşturmak. Kimlik üretebilen bir kimlik, tek bir işlemle iptal edilemez.
Bir anahtar, onu oluşturan kişinin rolünün ötesine de geçemez ve bu her istekte yeniden denetlenir — yani birinin rolünü düşürmek, anahtarlarını aynı gün daraltır.
Sormak yerine haber almak
eSIM’in sağlayıcıdan satın alınması arka planda olur, bu yüzden siparişi veren istek eSIM’i size döndüremez. Ortaya çıkana kadar yoklamak yerine bir webhook adresi kaydedersiniz ve hazır olduğunda biz haber veririz.
Her gönderim imzalanır; böylece sisteminiz mesajın bizden geldiğini, adresinizi tahmin eden birinden gelmediğini kanıtlayabilir. Sürekli hata veren bir adres, sebebi kaydedilerek kapatılır ve her deneme — başarılı olanlar dahil — saklanır, yani “gönderdiniz mi?” sorusunun gerçek bir yanıtı olur.