Ana içeriğe geç

Sunucu API Anahtarı Yönetimi

Bu makalede

Bilgi

Bir API key, [Invapi için API isteklerini yetkilendirmek ve kontrol merkeziniz ile kişisel hesabınızdan bağımsız olarak belirli bir sunucunun [[Control Panel]]'ine erişmek için kullanışlı bir yoldur.

Tüm hesaba veya belirli bir sunucuya erişmek için Invapi kontrol panelinin kişisel alanında bir API erişim anahtarı oluşturun. Onu elde etmek için bu talimatları izleyin.

Belirli bir sunucu için API key alma

  1. Invapi adresine gidin;

  2. Lütfen harici sunucu kontrol paneline erişmek istediğiniz sunucuyu seçin: My Servers >> You require a server;

  3. Bir API key oluşturun:

    • Configuration sekmesine gidin ve API keys & control panel bölümünü seçin.
    • Add new düğmesine tıklayın;

    • Name alanına, anahtarı tanımlamak için bir isim girin;
    • IP ACL alanında yalnızca bu anahtarın erişimine izin verilecek IP adreslerini belirtin veya kısıtlamasız erişim için boş bırakın;
    • Anahtarı etkinleştirmek için Active kutucuğunu işaretleyin;
    • Add new API key düğmesine tıklayın.

    API key size gösterilecektir.

Dikkat

API key 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.

Bir API key düzenleme veya silme

Bir API key'i düzenlemek veya silmek için hesabınıza veya anahtarın oluşturulduğu belirli bir sunucuya gidin ve istediğiniz anahtarın üzerine 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ı kullanarak yapılacak çağrılara izin verilecek IP adreslerini ayarlayın;

  • Bu API key ile giriş yapmak 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 (e-posta/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 düğmesine tıklayın.

Bir API key'i silmek için Delete API key düğmesine tıklayın.

Dikkat

API key bir kez silindikten sonra geri getirilemez.

API key kullanma

API key şu şekillerde kullanılabilir:

  1. Invapi'deki bir hesap veya sunucuya yapılacak sonraki API istekleri için gerekli olan oturum tokenını (session token) elde etmek için yetkilendirme gereklidir. Yetkilendirme, kullanılan API key'e 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ğlamak üzere bir API key üzerinden alınabilir. Yetkilendirme başarılıysa ve anahtar veritabanında bulunursa, sistem $HOSTKEY_TOKEN oturum tokenını döndürecektir.

  2. Invapi Control Center hesabınıza giriş yapmadan sunucu erişimi sağlayan [[Server Control Panel]]'e erişmek ve HOSTKEY sunucularını yönetmek için bir faturalandırma sistemine bağımsız bir modül olarak gömmek istiyorsanız, sunucuya özel API key'ler oluşturmalısınız.

API key kullanım bilgileri

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

Web paneli olmadan API key alma

API methods for working with API keys] kullanılarak web kontrol paneli kullanılmadan de bir API key elde edilebilir. Bu yöntemler komut satırından yürütülebilir veya web çözümlerine dahil edilebilir.