İçeriğe geç

Veriler, API ve entegrasyonlar

API anahtarları

CRM veya muhasebe aracı gibi kendi sistemlerinizin gizli bir anahtarla EasyHaus verilerini okumasına veya yazmasına izin verin.

  • Güncellendi
  • Yöneticiler için

Bunu kim yapabilir: Sahipler ve yöneticiler

Anahtar oluşturma

  1. Ayarlar sayfasını, ardından API anahtarları bölümünü açın ve Anahtar oluştur seçeneğini seçin.
  2. Anahtara, onu kullanacak sistemin adını verin. Bir Kapsam ve isteğe bağlı bir son kullanma tarihi seçin.
  3. Anahtarı şimdi kopyalayın ve sisteminizin gizli anahtar deposunda saklayın.

Important: Anahtarın tamamı yalnızca bir kez gösterilir. Kaybederseniz iptal edip yenisini oluşturun.

API anahtarı kapsamları
KapsamŞu rolle çalışır
Salt okunurGörüntüleyici. Görüntüleyicinin okuyabildiği her şeyi okuyabilir.
Okuma ve yazmaEn fazla müdür. Bir müdürün oluşturup değiştirebildiklerini oluşturabilir ve değiştirebilir.

Kullanma

Anahtarı, uygulamanın API’sine yapılan her isteğin Authorization başlığında gönderin:

Authorization: Bearer ehk_...

  • Bir anahtar yalnızca kendi kuruluşu için ve yalnızca kendi kapsamıyla çalışır.
  • Anahtar kullanıldığında CSRF başlığı gerekmez.
  • Bir anahtar başka anahtarlar oluşturamaz veya yönetemez.
  • Anahtarla yapılan istekler denetim kaydına API anahtarı olarak işlenir.

İptal et

Bir anahtarda İptal et seçeneğini seçtiğinizde anahtar hemen çalışmayı durdurur ve onu kullanan sistemler 401 hataları alır. Anahtarı oluşturan üye kuruluştan ayrıldığında da anahtar çalışmayı durdurur. Liste, her anahtarın en son ne zaman kullanıldığını gösterir.

Tip: Mümkün olduğunda her entegrasyona kendi salt okunur anahtarını verin. Biri sızarsa yalnızca onu iptal edersiniz.

Geliştiricileriniz için API açıklamasını almak üzere iletişim formu aracılığıyla talepte bulunun.

İhtiyacınızı bulamadınız mı?

Ne yapmaya çalıştığınızı bize anlatın. E-postayla yanıtlarız ve sorunuz bir sonraki rehberi yazmamıza yardımcı olur. Asla parola, kimlik numarası veya banka bilgisi göndermeyin.