API Anahtarı Oluşturma: LIONFIN Müşteri API’si ile Otomasyon

LIONFIN’de API anahtarı oluşturma işlemi, müşteri paneli içindeki API Anahtarları sayfasında anahtara bir ad verip izin kapsamını, isteğe bağlı IP kısıtını ve geçerlilik süresini seçtikten sonra Oluştur’a basmaktan ibarettir. Üretilen ve lf_ ile başlayan anahtar yalnızca bir kez gösterilir; yazılımınız onu Authorization: Bearer başlığıyla göndererek hesabınızdaki verileri okur.

Müşteri API’si (v1), panelde gördüğünüz hizmet, alan adı, fatura ve sipariş bilgilerini makinece okunabilir JSON olarak verir. Yaklaşan yenilemeleri muhasebe tablonuza aktarmak, alan adı bitiş tarihlerini izleme panonuza çekmek ya da ödenmemiş faturaları ekibinize bildirmek gibi tekrar eden kontrolleri elle yapmak yerine bir betiğe bırakabilirsiniz.

API anahtarı oluşturma: adım adım

Anahtarı yalnızca ana hesap sahibi oluşturabilir; alt kullanıcılar bu sayfaya erişemez. Adımlar:

1. Oturum açtıktan sonra sağ üst köşedeki adınıza tıklayın ve açılan listeden API Anahtarları’nı seçin (API Anahtarları sayfası).
2. Yeni API Anahtarı bölümündeki Anahtar adı alanına anahtarın nerede kullanılacağını anlatan bir ad yazın; örneğin “Muhasebe raporu” ya da “İzleme sunucusu” (en fazla 60 karakter).
3. Süre listesinden Süresiz, 30 gün, 90 gün ya da 1 yıl seçeneğini belirleyin.
4. İzin kapsamı kutularında yalnızca uygulamanızın ihtiyaç duyduğu verileri işaretli bırakın; form beş kapsamın tamamı seçili açılır ve en az biri zorunludur.
5. İsteklerin yalnızca belirli sunuculardan gelmesini istiyorsanız İzinli IP’ler alanını doldurun; boş bırakırsanız her IP adresinden istek kabul edilir.
6. Oluştur’a basın. Yeşil kutuda “bu anahtar yalnızca şimdi gösterilir” uyarısıyla anahtar belirir; Kopyala ile alıp hemen şifre yöneticinize ya da sunucunuzdaki gizli ortam değişkenine kaydedin.

Sayfanın üstündeki satır, isteklerin gönderileceği API tabanı adresini, Authorization: Bearer <anahtar> kullanım biçimini ve API dokümantasyonu bağlantısını gösterir. Anahtar sistemde geri döndürülemez biçimde saklandığı için kutuyu kapattıktan sonra bir daha görüntülenemez.

İzin kapsamları hangi verilere erişim verir?

Her kapsam tek bir uç noktayı açar; anahtarda olmayan bir kapsamın uç noktası çağrıldığında API 403 döndürür.

Uç noktaların tamamı okuma amaçlıdır: API üzerinden sipariş verilemez, fatura ödenemez ya da hizmet ayarı değiştirilemez. Liste döndüren uç noktalar yanıtı {"data": [ ... ]} biçiminde verir. Kapsamı işe göre daraltın: alan adı bitişlerini izleyen bir betik için yalnızca Alan adları, muhasebe aktarımı için Faturalar yeterlidir. Alan türleri ve açıklamaları herkese açık API belgelerinde yer alır.

İlk istek nasıl gönderilir? curl örneği

Anahtarı komut satırına açık yazmak yerine bir ortam değişkenine koyun; böylece komut geçmişine ve paylaştığınız betiklere düşmez. Aşağıdaki örnekte API_TABANI değerini API Anahtarları sayfasındaki API tabanı satırından kopyaladığınız adresle değiştirin:

export LIONFIN_API_ANAHTARI="lf_xxxxxxxxxxxxxxxx"
API_TABANI="https://www.example.com/api/v1"

curl -s -H "Authorization: Bearer $LIONFIN_API_ANAHTARI" \
     -H "Accept: application/json" \
     "$API_TABANI/me"

Yanıt hesabınızın kimlik, ad, e-posta, durum ve bakiye bilgisini döndürür. Yaklaşan ödemeleri listelemek için services uç noktasının çıktısını jq ile süzebilirsiniz:

curl -s -H "Authorization: Bearer $LIONFIN_API_ANAHTARI" \
     -H "Accept: application/json" \
     "$API_TABANI/services" \
  | jq -r '.data[] | "\(.next_due_date)  \(.name)"'

Bu betiği bir VPS sunucu üzerinde günde bir kez cron ile çalıştırıp çıktıyı e-postayla ya da ekip sohbetinize göndererek yenileme takibini otomatikleştirebilirsiniz. API’nin makinece okunabilir tanımı /api/openapi.json adresindedir ve OpenAPI 3 içe aktarmayı destekleyen istemcilere eklenebilir.

API ile hangi işler otomatikleştirilebilir?

API, panelde tek tek kontrol ettiğiniz tarihleri ve durumları düzenli tarayan küçük betikler yazmanızı sağlar. Sık kullanılan senaryolar ve gereken kapsamlar:

Durum alanları İngilizce kodlarla döner; faturalarda örneğin unpaid ödenmemiş, overdue gecikmiş, partially_paid kısmen ödenmiş, paid ödenmiş anlamına gelir. Tarih alanları YYYY-AA-GG biçimindedir; siparişlerdeki created_at ise saat ve saat dilimi bilgisini de içerir. Bu verileri mevcut izleme düzeninize bağlamak için sunucu izleme ve uptime takibi yazısındaki araçlardan yararlanabilirsiniz.

IP kısıtı ve süre nasıl ayarlanmalı?

İzinli IP’ler alanı, anahtarın yalnızca belirttiğiniz adreslerden gelen isteklerde çalışmasını sağlar. Girdileri virgül, boşluk ya da noktalı virgülle ayırabilirsiniz; üç biçim kabul edilir:

• Tek adres: 203.0.113.5; IPv6 adresleri de tek adres olarak yazılabilir.
• IPv4 CIDR aralığı: 10.0.0.0/8.
• Joker: 192.168.1.*, ilgili bloğun tüm adresleri.

Geçersiz bir girdi kaydı engeller ve “Geçersiz IP / aralık” uyarısı çıkar. Listede olmayan bir adresten gelen istek 403 ve “Bu IP adresine bu anahtarla erişim izni yok.” yanıtını alır. Alana bilgisayarınızın yerel ağ adresini değil, isteğin internete çıktığı genel IP’yi yazın; LIONFIN sunucularınızın IP adresi Hizmetlerim listesindeki Sunucu Erişimi satırında görünür.

Süre seçimi de bir güvenlik kararıdır. Süresi dolan anahtar listede süresi doldu etiketi alır ve istekleri 401 ile reddedilir. Kalıcı bir entegrasyon için süresiz anahtar kullanacaksanız IP kısıtını mutlaka doldurun; geçici bir test ya da danışmanla yürütülen kısa bir iş için 30 gün yeterlidir. Süreli anahtarları dönüşümlü yenileyin: bitişten önce yeni anahtar üretin, uygulamayı güncelleyin, eskisini iptal edin.

API hangi hata kodlarını döndürür?

API hataları JSON gövdesinde bir message alanıyla döner; en sık karşılaşılan üç durum şunlardır:

Hizmet ve fatura verileri dakikalar içinde değişmez; betiğinizin aynı uç noktayı saatte bir ya da günde birkaç kez çağırması çoğu iş için yeterlidir. Yanıtı yerelde saklamak hem sınıra takılmayı önler hem de betiği hızlandırır.

Anahtarlar nasıl izlenir ve iptal edilir?

Anahtarlarım listesi her anahtarın oluşturulma ve bitiş tarihini, son kullanım zamanını (hiç kullanılmadıysa “Hiç kullanılmadı”), toplam istek sayısını, kapsam etiketlerini ve varsa IP kısıtını gösterir.

• İstek kayıtları düğmesi, anahtarla yapılan son 50 isteği zaman, istek yolu, IP, durum kodu ve süre sütunlarıyla açar; 403 alan bir entegrasyonda sorunun IP mi kapsam mı olduğunu buradan anlarsınız.
• İptal Et, onayınızdan sonra anahtarı kalıcı olarak siler; onu kullanan uygulamalar bir sonraki istekte 401 alır.
• Anahtarı kaybettiyseniz ya da bir yerde açığa çıktığından şüpheleniyorsanız yeni anahtar üretin, uygulamalarınızı güncelleyin ve eskisini iptal edin.

Her uygulama için ayrı anahtar kullanın; anahtarı tarayıcıda çalışan JavaScript koduna, mobil uygulama paketine ya da herkese açık bir Git deposuna koymayın. API anahtarı yalnızca panel verilerine erişir, sunucuya bağlanmayı sağlamaz; sunucu girişini parolasız ve güvenli hâle getirmek için SSH anahtarı oluşturma rehberine bakın. Hesap genelindeki diğer önlemler müşteri paneli güvenliği yazısında toplanmıştır.