NES Portal’da API anahtarı nasıl oluşturulur?

Anahtar oluşturmadan önce erişim kapsamını belirleyin

NES Portal’da Yönetim Paneli → API Tanımları → Yeni API Anahtarı yolunu izleyin. Bu işlem, bir yazılım entegrasyonunun portal hesabıyla çalışabilmesi için kullanılan erişim bilgisini oluşturur. Başlamadan önce hangi firma hesabında ve hangi entegrasyon amacıyla çalıştığınızı kontrol edin. Elinizde yalnız bir eğitim örneği varsa gerçek hesabınızda deneme anahtarı oluşturmanız gerekmez.

Kaynak video, belge türlerine ait sekmelerde geniş bir yetki seçimi gösterir. Bunu her uygulama için varsayılan kurulum olarak uygulamayın. Entegrasyonun gerçekten yapacağı işlemleri belirleyin ve gereken izinleri teknik sorumlusuyla doğrulayın. Örneğin yalnız kayıt okuyan bir bağlantı ile belge oluşturan bağlantının ihtiyaçlarını aynı kabul etmeyin; ekranda görünen bütün izinleri otomatik seçmekten kaçının.

Açıklama ile son geçerlilik tarihini birlikte değerlendirin

Açıklama alanına anahtarın hangi yazılım veya bağlantı için kullanılacağını ayırt eden bir ad yazın. Kaynak anlatıma göre bu açıklama portalda görünen başlıktır; anahtarın kendisi değildir. Aynı firmada birden fazla bağlantı varsa anlaşılır bir ad, sonradan hangi kaydın neye ait olduğunu bulmayı kolaylaştırır. Açıklama alanına parola ya da başka bir gizli bilgi yazmayın.

Son Geçerlilik Tarihi alanını kaydetmeden önce kontrol edin. NES’in bu video açıklaması ve anlatımı, tarih seçilmezse anahtarın süresiz kullanılabileceğini belirtir. Süreli veya süresiz tercihi, bağlantının kullanım ihtiyacına göre verilmelidir. Tarih belirliyorsanız ilgili kişinin bunu bilmesini sağlayın; sürenin bitmesiyle ortaya çıkabilecek erişim sorununu fatura verisi hatasıyla karıştırmayın.

Tek seferlik görüntüyü güvenli biçimde saklayın

Kaydet işleminden sonra API anahtarı yalnız bir kez gösterilir. Videoda Kopyala ve Kapat düğmesiyle bu pencere tamamlanır. Anahtarı yalnız onaylı entegrasyonun güvenli yapılandırmasında veya uygun sır saklama alanında tutun. Herkese açık kod, ekran görüntüsü, e-posta zinciri veya bu rehberin herhangi bir alanı anahtar için saklama yeri değildir. Buradaki anlatım için gerçek anahtarınızı paylaşmanız gerekmez.

Anahtar oluşturulmuş olması entegrasyonun çalıştığını kanıtlamaz. Yetki kapsamı, doğru ortam ve bağlantı ayarı ayrıca kontrol edilmelidir. Eğitim kapsamında hesabınıza bağlanılmadı, anahtar oluşturulmadı ve belge gönderilmedi. Entegrasyon kontrolünü yetkili teknik kişiyle, işleminizi etkilemeyecek uygun test akışı üzerinden yapın.

Kullanılan anahtarı silmeden önce bağlantısını bulun

NES’in kaynak video açıklaması, entegrasyonda kullanılan anahtar portalda silinirse bağlantının çalışmayacağını ve yeni anahtarın entegrasyonda güncellenmesi gerekeceğini belirtir. Bu nedenle gereksiz görünen bir kaydı silmeden önce hangi yazılımın kullandığını belirleyin. Bir sorun çıktığında bütün anahtarları silip tekrar açmak yerine açıklama, geçerlilik ve izin kapsamını sırayla inceleyin. Gerçek anahtar değerini destek talebine eklemeyin.