Araçlarınızı API ile bağlayın
API, üçüncü taraf bir uygulamanın organizasyonunuzun verilerine programatik olarak erişmesini sağlar: üye sayıları, takvimler, rezervasyonlar ve faturalandırma. İki tıklamayla etkinleştirilir ve bir anahtar, izin verilen adres listesi ve kullanım takibi ile korunur.
API'nin sizi ilgilendirip ilgilendirmediğini anlayın
API, bir organizasyon sorumlusuna değil, bir geliştiriciye yöneliktir. Hesabınızın, yazdırdığınız veya yapılandırdığınız bir yazılımla iletişim kurmasını sağlar: özel bir web sitesi, bir muhasebe aracı, kendi yaptığınız bir görüntüleme ekranı, başka bir sisteme açılan bir köprü.
Günlük ihtiyaçlar için — üye listesini almak, abonelikleri toplu olarak güncellemek, yönetim kuruluna rakamlar iletmek — içe aktarma, dışa aktarma ve rapor modülleri tek satır kod yazmadan yeterli olur.
API beta sürümünde sunulmaktadır: çalışma biçimi henüz değişebilir.
API'yi etkinleştirin ve anahtarınızı alın
- Yönetim›Ayarlar›API BETA bölümüne gidin.
- API modülünü etkinleştir seçeneğini etkinleştirin, ardından Kaydet üzerine tıklayın.
- API Anahtarı görüntülenir: Kopyala düğmesiyle kopyalayın ve yalnızca bağladığınız araca iletin.
Anahtar, her isteğin X-API-Key HTTP başlığında iletilir. Çağrılar zorunlu olarak HTTPS üzerinden yapılır; şifrelenmemiş hiçbir istek kabul edilmez.
Anahtarı koruyun
Anahtarı kullanan araca veya hizmet sağlayıcıya hatırlatılması gereken birkaç iyi alışkanlık:
- anahtarı asla bir kod deposuna koymayın; depo dışındaki bir yapılandırma dosyasında veya bir gizli anahtar yöneticisinde saklayın;
- araç sabit bir sunucudan çağrı yaptığı anda izin verilen adresleri kısıtlayın;
- en küçük şüphede anahtarı yeniden oluşturun — kazara yayınlama, günlük kayıtlarının sızması, bir hizmet sağlayıcının görevinin sona ermesi.
Yeniden oluştur düğmesi onay ister, ardından eski anahtarı anında geçersiz kılar. Onu kullanan tüm uygulamalar, yenisini alana kadar çalışmayı durdurur: tıklamadan önce onları bilgilendirin.
Erişimi IP adresine göre kısıtlayın
IP adresine göre kısıtlama seçeneğini etkinleştirin: yalnızca listelediğiniz adreslerden gelen istekler kabul edilir, en fazla 10 IPv4 adresi olmak üzere. Her adresi girin ve Ekle ile onaylayın; size yardımcı olmak için mevcut adresiniz ekranda gösterilir.
Bu, en etkili ve aynı zamanda en sık ihmal edilen korumadır: açığa çıksa bile, hizmet sağlayıcınızın adresine kısıtlanmış bir anahtar başka yerde kullanılamaz.
Kullanımı takip edin
Ekran, anahtarınızın tükettiği kaynakları sürekli olarak gösterir:
- Bu dakika kullanılıyor ve Bugün Kullanım, bir limit yapılandırıldığında her biri kendi limitine göre gösterilir;
- Kullanım İstatistikleri: Bu hafta, Bu ay, Toplam ve Son istek.
Belirtilen limitlerin ötesinde, ek istekler geçici olarak reddedilir. Sürekli olarak üst sınırına yaklaşan bir sayaç, genellikle kötü ayarlanmış bir aracı gösterir: aynı verileri önbelleğe almak yerine sürekli tekrar isteyen bir araç.
Son istek tarihi ise tersi yönde yararlıdır: etkinleştirilmiş ama aylardır hiç çağrılmamış bir anahtar, devre dışı bırakılması gereken bir anahtardır.
API'nin neler yapabileceğini keşfedin
Parametreleri ve çağrı örneklerini içeren eksiksiz belgeler, modül ekranının altında görüntülenir. Ana hatlarıyla:
- Kullanıcılar: değiştirilebilen tek kaynaktır. Hesapları listeleyebilir, görüntüleyebilir, oluşturabilir, değiştirebilir ve silebilirsiniz.
- Yapılandırma: abonelikler, profiller, gruplar ve yaş kategorileri görüntülenebilir, ancak yalnızca uygulamadan yapılandırılabilir.
- Rezervasyon: takvimler, uygun zaman dilimleri, rezervasyonlar ve etkinlik etiketleri görüntülenebilir.
- Faturalandırma: fatura hesapları, siparişler ve ödemeler görüntülenebilir.
