SelSup Developers

SelSup platformu · Rehberler

Genişlemeler ve özel entegrasyonlar

Dış bir arka uç hizmet, gömülü bir React UI ve sunucu tarafındaki bir pazar veya teslimat modülü arasında seçim yapmak.

5 bölümlerGeliştiriciler rehberi
→

Çoğu entegrasyon, API'i kullanan bir dış arka uç olarak başlamalıdır. Kullanıcılar SelSup'in içinde doğrudan özelliği çalıştırmak zorunda kaldığında yerleşik bir kullanıcı arazi uyguntur.

Uygulama geliştiricileri ve teknoloji ortakları

01

Entegreci türü seçin

  1. 1

    Dış arka uç hizmeti

    ERP, web mağazası, WMS, BI ve benzer senkronizasyon için en iyisi. Token sunucunuzda kalır ve veriler API ve webhooks üzerinden hareket eder.

  2. 2

    Reaktör genişleme

    SelSup'in içinde çalıştırılması ve ürünün etkileşim kalıplarını yeniden kullanması gereken bir kullanıcı arayüzü için kullanın.

  3. 3

    SelSup arka uç modülü

    Ortak SelSup arka plan süreçlerine katılan derin bir pazar veya teslimat entegrasyonu için gereklidir.

i
Uçuk bir dikey parça ile başla

Bir bütünlü iş akışı ve gözlemlenebilirliğini uygulamak önce.

02

Dış uygulama mimarisi

Tokeni bir sır yöneticisi içinde tutun ve SelSup'i sadece arka uçtan arayın. Tarayıcı uygulamanız API ile konuşmalı ve SelSup tokenini asla almamalıdır.

SelSup adaptörünü, iş kuyrukunu ve alan modelini ayırın. API sözleşme değişiklikleri, daha sonra uygulama geri kalanından izole edilir.

Giren etkinlikler için bir gelen kutusu ve giden değişiklikler için bir çıkış kutusu kullanın.

Veriler akışı · Text
SelSup webhook → inbox → domain worker → ERP/WMS
ERP/WMS change → outbox → SelSup API → reconciliation

İlişkili API uç noktaları

GET/api/product/findSözlük okuması örneğiGET/api/order/findGelişmiş senkronizasyon örneği

03

Eklemiş React uzantısı

Komponent SelSup arayüzünde çalışır. Dış bir alan selsup.ru'dan talepleri izin vermeli ve tarayıcı kısıtlamalarını doğru şekilde yönetmelidir.

Bir API tokenini asla paketle paylaşmayın. Uzantı mimarisi tarafından tanımlanan arka uç ve kısa ömürlü kullanıcı bağlamı üzerinden ayrıcalıklı çalışmayı yönlendirin.

Ürün etkileşim modellerini eşleştirin ve erişilebilir boş, yükleme ve error durumlarını kaplayın.

!
CORS yetkisi değildir.

İzin verilen bir kaynak tarayıcı erişimini kontrol eder ancak bir kullanıcıyı kimliklendirmeyi yapmaz. Her hassas işlem hala sunucu tarafındaki izin kontrollerine ihtiyaç duyar.

Demo bileşenleri · URL
https://github.com/SelSup/component

04

Sunucu taraflı entegrasyon modülü

Bir pazar entegrasyonu genellikle jetonları, kartları, fiyatları, stokları, siparişleri ve arka plan durum güncellemelerini kapsar.

Bu modül SelSup'in ana arka planını değiştirir ve onun inceleme, test, yerleştirme ve serbest bırakma sürecini takip eder. Uygulama öncesi arayüzler ve veri sınırları konusunda anlaşın.

Dış API hatalarını sabit ApplicationError değerlerine ve iptal edilmiş veya geçersiz dış jetonları AccessException'e dönüştürmek için arka uç proje kurallarına göre.

i
Paylaşılan veri uyumluluğu

Ortak kurumlara pazar-özel alanlar eklemeyin.

05

Serbest bırakma ve çalıştırma

  1. 1

    Test hesabı oluştur

    Müşterilerin üretim verilerinden test tokenlerini, depolarını, ürünlerini ve siparişlerini ayırmak.

  2. 2

    Gözlemselliği ekle

    Sırada gecikme, kod hataları, tekrar deneme sayıları ve uzlaşma çelişkileri izleyin.

  3. 3

    Planlı sözleşme göçü

    Geçirken eski alanları destekleyin ve eski biçimi devre dışı bırakmadan önce tüketicileri dağıtın.

  4. 4

    Belge bağlantısını kes

    Kullanıcılar bir token'ı nasıl iptal edeceğini, bir webhauk'u nasıl kaldırılacağını ve verileri kaybetmeden senkronizasyonu nasıl durdurulacağını bilmeliler.