Sunucu API Anahtarı Yönetimi¶
Bu makalede
Bilgi
Bir API anahtarı, Invapi'ye API taleplerini yetkilendirilmiş bir şekilde yapmanıza ve belirli bir sunucunun Kontrol Panelini kontrol merkezinden ve kişisel hesabınızdan bağımsız olarak erişmenize olanak sağlar.
Hesap veya belirli bir sunucuya erişmek için, Invapi kontrol panelinin kişisel alanından bir API erişim anahtarı oluşturun. Bunu elde etmek için aşağıdaki adımları izleyin.
Belirli Bir Sunucu İçin API Anahtarı Alma¶
-
Invapi 'ye gidin;
-
Harici sunucu kontrol paneline erişmek istediğiniz sunucuyu seçin: My Servers >> You require a server;
-
API anahtarı oluşturun:
- Info sekmesine gidin ve API keys seçeneğini belirleyin.
Add new API-keydüğmesini tıklayın;
- Name alanına anahtarı tanımlamak için bir isim girin;
- Bu anahtarın yalnızca belirtilen IP adreslerinden erişim sağlayabileceği şekilde IP ACL alanını belirtin veya kısıtlama olmadan erişim için boş bırakın;
- Anahtarı aktifleştirmek için Active kutusu işaretleyin;
Add new API keydüğmesine tıklayın.
API anahtarı size görüntülenir.
Dikkat
API anahtarının değerini kopyalayıp kaydedin çünkü yalnızca bir kez görüntülenecektir. Invapi sadece anahtarın hash değerini depolar, bu nedenle orijinal anahtar kaybolursa yeniden oluşturulmalıdır.
API Anahtarı Düzenleme veya Silme¶
Bir API anahtarını düzenlemek veya silmek için, oluşturulduğu hesaba veya belirli sunucuya gidin ve istediğiniz anahtara tıklayın. Görünen pencerede General Info sekmesine giderek:
- Name alanında anahtarın adını değiştirebilirsiniz;
- IP ACL alanında anahtar kullanılarak yapılan çağrıların yasaklanacağı IP adreslerini belirleyebilirsiniz;
- Bu API anahtarının iletilmesini ayarlayabilir veya belirleyebilirsiniz. Bu yalnızca tüm hesap için verilen anahtarlar için geçerlidir ve bildirimler için e-posta/URL alanını içerir;
- Active kutusu işaretleyerek bu özelliği etkinleştirebilir veya geçici olarak devre dışı bırakabilirsiniz.
Ardından değişikliklerinizi kaydetmek için Save API key düğmesine tıklayın.
Bir API anahtarını silmek için Delete API key düğmesini tıklayın.
Dikkat
API anahtarı, silindikten sonra geri alınamaz.
API Anahtarı Kullanımı¶
API anahtarı aşağıdaki şekillerde kullanılabilir:
-
Invapi hesabına veya sunucusuna yönelik sonraki API talepleri için gereken oturum tokenini almak amacıyla kullanılır. Yetkilendirme, hesapla veya belirli bir sunucuya erişim sağlayan API anahtarını kullanarak auth/login çağrısıyla elde edilebilir. Kullanılan API anahtarı dikkate alınarak tüm hesap veya belirli bir suncuya erişime izin verilir. Yetkilendirme başarılı olur ve anahtar veri tabanında bulunur ise sistem
$HOSTKEY_TOKEN
oturum tokenını döndürür. -
Sunucu Kontrol Paneli'ne (../resellers/controlpanel.md) erişmek, Invapi Kontrol Merkezi hesabınıza giriş yapmadan sunucuya erişim sağlamak ve HOSTKEY sunucularını yönetmek için faturalandırma sisteminize bağımsız bir modül olarak entegre etmek amacıyla sunucu özel API anahtarları oluşturmanız gerekir.
API Anahtarına İlişkin Kullanım Bilgileri¶
Usage history sekmesinde, bir hesaba veya suncuya ait belirli bir anahtar seçin ve belirli bir dönem içinde 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 tarihinde ve saatini içerir.
Web Paneli Olmadan API Anahtarı Elde Etme¶
Web kontrol panelini kullanmadan bir API anahtarı, API anahtarları ile çalışmak için API yöntemleri kullanılarak elde edilebilir. Bu yöntemler komut satırı veya web çözümlerine entegre edilerek gerçekleştirilebilir.