SelSup Developers

La plateforme SelSup · Les guides

Extensions et intégrations sur mesure

Choisir entre un service backend externe, une interface utilisateur React intégrée et un marché ou un module de livraison côté serveur.

5 sectionsGuide du développeur
→

La plupart des intégrations devraient commencer comme un backend externe utilisant le public API. Une interface utilisateur intégrée est appropriée lorsque les utilisateurs doivent utiliser la fonctionnalité directement à l'intérieur de SelSup.

Des développeurs d'applications et des partenaires technologiques

01

Choisissez le type d'intégration

  1. 1

    Service de backend externe

    Le jeton reste sur votre serveur et les données se déplacent à travers API et les webhooks.

  2. 2

    Extension de réaction

    Utilisez-le pour une interface utilisateur qui doit fonctionner à l'intérieur de SelSup et réutiliser les modèles d'interaction du produit.

  3. 3

    Module de rétroaction SelSup

    Requérée pour une intégration de marché ou de livraison approfondie participant à des processus partagés de fond SelSup.

i
Commencez par une tranche verticale mince

Mettre en œuvre un flux de travail complet et son observabilité d'abord. Ajouter des importations en vrac, UI et plus de types d'événements après la réconciliation est stable.

02

Architecture d'applications externes

Gardez le jeton dans un gestionnaire de secrets et appelez SelSup uniquement depuis votre backend.

Séparer l'adaptateur SelSup, la file d'attente et le modèle de domaine.

Utilisez une boîte de réception pour les événements entrants et une boite de sortie pour les changements sortants.

Flux de données · Text
SelSup webhook → inbox → domain worker → ERP/WMS
ERP/WMS change → outbox → SelSup API → reconciliation

Points d'extrémité API connexes

GET/api/product/findExemple de lecture du dictionnaireGET/api/order/findExemple de synchronisation en augmentation

03

Extension intégrée de React

Le composant fonctionne à l'intérieur de l'interface SelSup. Un domaine externe doit permettre les demandes de selsup.ru et gérer correctement les restrictions du navigateur.

Ne jamais placer un jeton API permanent dans le paquet. Route le travail privilégié à travers votre backend et le contexte utilisateur de courte durée défini par l'architecture d'extension.

Convient à l'interaction des produits et couvre les états de vide, de chargement et d'eerror accessibles.

!
Le CORS n'est pas une autorisation

Une source autorisée contrôle l'accès du navigateur mais n'a pas authentifié un utilisateur.

Component démo · URL
https://github.com/SelSup/component

04

Module d'intégration côté serveur

Une intégration de marché couvre généralement des jetons, des cartes, des prix, des stocks, des commandes et des mises à jour de l'état des antécédents.

Ce module modifie le backend principal SelSup et suit son processus d'examen, de test, de localisation et de sortie.

Convertir les défaillances externes API en valeurs stables d'ApplicationError et les jetons externes annulés ou invalides en AccessException selon les règles du projet backend.

i
Compatibilité des données partagées

Ne pas ajouter de champs spécifiques au marché aux entités partagées.

05

Libération et exploitation

  1. 1

    Créer un compte de test

    Les données de production des clients doivent être fournies par des tests séparés, des entrepôts, des produits et des commandes.

  2. 2

    Ajouter l'observabilité

    Suivez le retard de la file d'attente, les erreurs par code, les recensements et les divergences de réconciliation.

  3. 3

    Plan de migration par contrat

    Soutenir les anciens champs pendant une transition et déployer les consommateurs avant de désactiver l'ancien format.

  4. 4

    Déconnexion du document

    Les utilisateurs doivent savoir comment révoquer un jeton, supprimer un webhook et arrêter la synchronisation sans perdre de données.