Çalışma alanları
Bir anahtar tam olarak tek bir çalışma alanına aittir. Bunun çok kiracılı uygulamalar için ne anlama geldiği ve bir Bitrix24 portalının bağımsız bir çalışma alanından farkı.
Bir çalışma alanı, WhatsApp bağlantılarının sahibidir. Bir API key tam olarak tek bir çalışma alanı adına verilir ve anahtarın görebildiği ya da yapabildiği her şey o çalışma alanıyla sınırlıdır; başka bir çalışma alanını sorgulamanın yolu yoktur.
Bir anahtar, bir çalışma alanı, çok sayıda bağlantı
Çok kiracılı bir uygulama için istediğiniz yapı budur:
- Kiracı başına değil, tek bir API key. Her müşteri için ayrı anahtar üretmeyin.
- İlk kiracı dahil, her kiracı için bir
POST /connections; her biri kendi yeniIdempotency-Keydeğeriyle. - Gelen olayları
connection_idile yönlendirin. Bu, değişmeyen bir cuid'dir ve her REST yanıtında ile her webhook yükünde yer alır. Onu kendi müşteri kaydınızla eşleştirin; kimliği biz üretiriz, eşlemeyi siz yaparsınız. - Yeni bağlantılar hemen kullanılabilir. Anahtarın bağlantı listesi her istekte canlı olarak çözümlenir, dolayısıyla oluşturma sonrasında yenilenecek bir şey yoktur.
İki tür çalışma alanı
Bağımsız çalışma alanı
developers.wasync.app adresinde kayıt olduğunuzda oluşturulur. Ürünün tamamı API'dir: bağlantıları REST üzerinden oluşturursunuz ve her bağlantının kendi lisansı vardır.
Bitrix24 portalı
WASync bir Bitrix24 portalına kurulduğunda oluşturulur. Bağlantıları portal yöneticisi WASync içinde oluşturur ve bir numaraya API erişimi ücretli bir eklentidir.
Fark tam olarak iki yerde ortaya çıkar. Yanlış olana karşı kod yazmadan önce bunları bilmeniz iyi olur:
Bağlantı oluşturma. POST /connections yalnızca bağımsız çalışma alanlarında
kullanılabilir. Bir Bitrix24 portalında 403 forbidden_portal_kind yanıtı verir;
bağlantıları bunun yerine portal yöneticisi WASync arayüzünde oluşturur. Diğer
tüm uç noktalar her iki türde de aynı şekilde çalışır.
Bir bağlantıyı erişilebilir kılan nedir. Bağımsız bir çalışma alanında bu,
bağlantının kendi lisansıdır (deneme veya ücretli). Bir Bitrix24 portalında ise
portalın aboneliği numaranın CRM'deki ücretini karşılar; aynı numaraya API
üzerinden ulaşmak için ayrıca numara başına aylık 12 $ tutarındaki API
eklentisi gerekir. Eklenti olmadan bağlantı GET /connections yanıtında yer almaz.
Başlangıç
Bir API key ile bir başlangıç adımı yoktur: anahtar doğrudan çalışma alanınız
adına verilir; dolayısıyla POST /connections ilk bağlantıyı da onuncu bağlantı
kadar kolay oluşturur.
OAuth yetkisi yapısı gereği farklıdır: yalnızca zaten var olan bağlantılar üzerinde verilir. Bu yüzden yalnızca OAuth kullanan bir entegrasyon, bir çalışma alanının ilk bağlantısını oluşturamaz. Buradaki her hızlı başlangıç kılavuzunun bir anahtarla başlamasının nedeni budur.