Ana içeriğe geç

Invapi hesap erişim API Anahtarları yönetimi

Bu makalede

API anahtarı, API isteklerine kesintisiz erişim için Invapi'ye kimlik doğrulamada kullanılabilecek kullanışlı bir araçtır.

Dikkat

Bir hesap API anahtarı almak, yalnızca hesabın pozitif (sıfır olmayan) bakiyesi varsa mümkündür.

API erişim anahtarı, tüm hesaba erişim için veya belirli bir sunucuya erişim için Invapi kontrol panelindeki kişisel hesapta oluşturulur. Hesap için bir API anahtarı almak için aşağıdaki talimatları izleyin:

Tüm Invapi hesabı için API Anahtarı Alma

  1. Invapi adresine gidin ve Username >> API keys kısmına tıklayın.

  2. Bir API anahtarı oluşturmak için New API key butonuna tıklayın.

    • Name alanında anahtarı tanımlamak için adını girin;
    • Restrict a new API key only for the server açılır listesinden, anahtarın tüm hesap (Any) için mi yoksa belirli bir sunucu için mi geçerli olacağını seçin;
    • IP ACL alanını kullanarak bu anahtar ile hangi IP adreslerinden erişime izin verileceğini belirtin veya kısıtlamasız erişim için boş bırakın.
    • Set login notification method açılır listesinden, bu API anahtarı kullanılarak hesaba erişim için bir bildirim yöntemi seçin. Seçenekler şunlardır:
      • None (bildirim gönderilmez);
      • E-mail
      • Webhook - giriş bilgilerini bir HTTP çağrısı yoluyla web sitenize gönderir.
    • E-mail veya Webhook seçerseniz, Notification address (email/URL) alanına ilgili e-posta adresini veya URL'yi girin.
    • Anahtarı aktifleştirmek için Active onay kutusunu işaretleyin;
    • Yeni bir API anahtarı eklemek için Create etiketli butona tıklayın.

    API anahtarı size gösterilecektir.

Dikkat

API anahtarı değeri yalnızca bir kez gösterileceği için mutlaka kopyaladığınızdan ve kaydettiğinizden emin olun. Invapi, anahtarın yalnızca hash değerini saklar, bu nedenle orijinal anahtar kaybedilirse yeniden oluşturulması gerekecektir.

Tüm Invapi hesabı için API Anahtarlarını Yönetme

Bir API anahtarını düzenlemek veya silmek için, anahtarın oluşturulduğu hesabınıza gidin ve istediğiniz anahtara tıklayın. Açılan pencerede, şunları yapabileceğiniz General Info sekmesine gidin:

  • Name alanında anahtarın adını değiştirin;
  • IP ACL alanında, anahtar kullanılarak yapılacak çağrıların yasaklanacağı IP adreslerini ayarlayın;
  • Bu API anahtarı ile giriş yapma işlemi için bildirim yöntemini değiştirin veya ayarlayın. Bu, yalnızca tüm hesap için oluşturulan anahtarlar için geçerlidir ve bildirim adresi (email/URL) alanını içerir;
  • Active onay kutusunu kullanarak bu özelliği etkinleştirin veya geçici olarak devre dışı bırakın.

Ardından, değişikliklerinizi kaydetmek için Save API key butonuna tıklayın.

Bir API anahtarını silmek için Delete API key butonuna tıklayın.

Dikkat

API anahtarı silindikten sonra geri getirilemez.

Tüm Invapi hesabı için API Anahtarını Kullanma

API anahtarı, Invapi'deki bir hesap için sonraki API istekleri için gereken oturum tokenını (session token) elde etmek için kullanılabilir, yetkilendirme gereklidir. Yetkilendirme, kullanılan API anahtarına bağlı olarak, auth/login çağrısı aracılığıyla ya tüm hesap ya da belirli bir sunucu için erişim sağlayan bir API anahtarı üzerinden alınabilir. Yetkilendirme başarılı olursa ve anahtar veritabanında bulunursa, sistem $HOSTKEY_TOKEN oturum tokenını döndürecektir.

Tüm Invapi hesabı için API Anahtarı Kullanım Bilgileri

Usage history sekmesinde, bir hesap için belirli bir anahtar seçin ve belirli bir süre boyunca bu API anahtarı ile yapılan tüm girişleri görüntülemek için üzerine tıklayın. Çıktı; giriş için kullanılan e-posta adresini ve IP adresini, başarı durumunu ve olayın tarih ve saatini içerecektir.

Web kontrol paneli olmadan Tüm Invapi hesabı için API Anahtarı Alma

API anahtarları ile çalışmak için API yöntemleri kullanılarak web kontrol paneli kullanılmadan bir API anahtarı alınabilir. Bu yöntemler komut satırından yürütülebilir veya web çözümlerine dahil edilebilir.