Erişim

Erişim ve planlar

Entegrasyon API’si Exchange dahil her planda açıktır; açtırmanız gereken bir şey yoktur. Şirketinizin Sahibi ya da bir Yöneticisi, Quatlas’ı beklemeden entegrasyonları uygulamada kendisi oluşturur.

Planın belirlediği kapasitedir. Varsayılan değerler:

	Exchange	Enterprise
Canlı entegrasyon	1	5
Test entegrasyonu (deneme alanı)	1	5
Anahtar başına dakikada çağrı	60	300
Şirket başına günlük belge yükleme	50 dosya, 250 MB	200 dosya, 1 GiB

Canlı ve test entegrasyonları ayrı sayılır; canlı entegrasyonunuz kullanımdayken deneme alanı açık kalır. Tüm kapsamlar, webhook’lar ve deneme alanı iki planda da vardır; güvenlik özellikleri de öyle: OAuth, IP izin listesi, bitiş ve yenileme, iki adımlı doğrulama, çağrı kaydı ve denetim kaydı. Daha fazla kapasite için [email protected] adresine yazın.

Şirketiniz Enterprise’dan Exchange’e geçerse hiçbir şey iptal edilmez: her entegrasyon Exchange hızıyla çalışmaya devam eder ve anahtarları yenilenebilir. Şirket yeniden Exchange sınırının altına inince yeni bir canlı entegrasyon oluşturulabilir.

Quatlas ekibi API’yi bir şirket için kapatabilir; o zaman anahtarları hemen reddedilir.

Entegrasyon oluşturma

Bir entegrasyon, sistemlerinizden birine giden, kendi anahtarları olan bir bağlantıdır.

İki adımlı doğrulamayla oturum açın. Entegrasyon oluşturmak, anahtar yenilemek ya da iptal etmek bunu ister.
Ayarlar > Entegrasyonlar sayfasını açıp Yeni entegrasyon’u seçin.
Formu doldurun:
- Ad: sistemin ne olduğu, örneğin “eBA”. Çağrılar bir kişi adına değil, entegrasyonun kendi servis kimliğiyle (“Integration: eBA”) yapılır.
- Canlı ya da test: test entegrasyonu yalnız deneme alanınızda çalışır. Test olanla başlayın.
- Kapsamlar: anahtarın neler yapabileceği (aşağıda). Yalnız sistemin ihtiyacı olanları verin.
- Bitiş: en fazla 12 ay; varsayılan 12 ay.
- IP izin listesi (isteğe bağlı): anahtarın kullanılabileceği adresler ya da CIDR blokları, en fazla 20 giriş, IPv4 ve IPv6. Boş liste her kaynak demektir.
- Yalnız OAuth (isteğe bağlı): anahtar bu durumda yalnız belirteç adresinde çalışır ve her çağrı 15 dakikalık bir belirteç taşır. Bkz. Kimlik doğrulama.
Anahtarı Anahtarı şimdi kopyalayın ekranından kopyalayın. Yalnız bu kez gösterilir ve hiçbir yerde saklanmaz: Quatlas yalnız anahtarın sunucu anahtarıyla alınmış bir özetini tutar. Anahtarı hemen bir gizli anahtar kasasına koyun (örneğin Azure Key Vault, HashiCorp Vault ya da BPM aracınızın şifreli parametreleri).

Bir şirket planının izin verdiği kadar canlı ve test entegrasyonu tutar (yukarıya bakın); her entegrasyonun en fazla 2 etkin anahtarı (bir yenilemenin eski ve yeni anahtarı) olur. Yeni bir entegrasyon oluşturulduğunda şirketinizin diğer Sahip ve Yöneticilerine haber verilir.

Kapsamlar

Kapsam	İzin verdiği
`requests:write`	Taslak ya da yayında taşıma talebi oluşturma; API’den açılan talepleri uygulamanın talep sahibine izin verdiği yerde güncelleme ve iptal, onlar üzerinde kendi metadata alanlarınızı tutma. Uygulamada açılan talep okunur, asla yazılmaz. Deneme alanında talep ilerletme (test anahtarı).
`requests:read`	Talebin durumunu, teklif sayısını ve anlaşmasını kimlikle ya da `externalReference` ile okuma.
`deals:read`	Şirketinizin taraf olduğu anlaşmaları okuma: fiyat, Incoterm, karşı taraf ve aşama.
`tracking:read`	Anlaşmanın kilometre taşlarını, planlanan ve güncel teslim tahminini ve teslimi okuma. Canlı konum yoktur.
`documents:read`	Anlaşmanın belgelerini listeleme ve virüs taramasından temiz geçmiş belge için 5 dakikalık indirme bağlantısı.
`documents:write`	Şirketinizin taraf olduğu anlaşmalara, uygulamanın yükleme kurallarıyla belge yükleme.
`costs:read`	Anlaşmanın ek maliyetlerini (onaylı ya da beyan edilmiş) ve hesap özeti toplamlarını okuma; toplamlar yalnız anlaşılan maliyetleri sayar (henüz anlaşılmamış beyan edilenler `declaredTotal` içindedir).

Anahtarın kapsamı dışındaki bir rotaya yapılan çağrı 403 ve Integration.Forbidden alır. Sahip ya da bir Yönetici anahtarın kapsamlarını daha sonra iki adımlı doğrulamayla değiştirebilir; değişiklik gerekçesiyle denetim kaydına geçer.

Sahip ve Yöneticilerin gördükleri

Ayarlar > Entegrasyonlar altında şirketinizin Sahip ve Yöneticileri her entegrasyonu ve anahtarlarını (önek, kapsamlar, kimlik, bitiş, son kullanım ve durum) ve şunları görür:

Çağrı kaydı: her çağrının zamanı, anahtarı, rotası, yanıtı, süresi ve idempotency anahtarının özeti; 365 gün saklanır ve CSV olarak indirilir. Sisteminizin gönderdiği veri kayda girmez.
Denetim kaydı: bir anahtardaki her değişiklik; kim, ne zaman ve neden yaptı.
Webhook’lar: abonelikler, gönderim kayıtları, yeniden gönderim ve test olayları. Bkz. Webhook’lar.

Anahtarın öneki

Canlı anahtar qk_ ve ardından 43 karakterdir; test anahtarı qk_test_ ve ardından 43 karakter. İşaretle birlikte işaretten sonraki ilk 12 karakter anahtarın önekidir: uygulama anahtarları ayırt etmek için onu gösterir, OAuth’ta da client_id odur. Önek gizli değildir; anahtarın geri kalanı gizlidir.