IOSOR

IOSOR Znalosti

Vstupování API vs. partnerský portál white-label

SaaS produkty, které vkládají zprávy, zůstávají v rozhraní ISV. Partnerské portály white-label patří pod sekci Partner — nemíchejte značku, klíče a vlastníky.

Když SaaS produkt vkládá zprávy, koncoví uživatelé nikdy neotevřou konzoli IOSOR. Kliknou na Odeslat uvnitř rozhraní ISV; ISV vlastní klíče, webhooky a předplacený účetní deník. Tato cesta je embed. Partnerský portál white-label je jiný: správce partnera pracuje v rozhraní Partner — se zabezpečením značky, izolací nájemců a branami, které nikdy neodhalují názvy infrastruktur.

Týmy tyto dvě věci často míchají: snímky obrazovky partnera v prezentaci ISV nebo chybové zprávy připomínající IOSOR uvnitř produktu SaaS. Embed znamená, že váš produkt je jediným rozhraním určeným pro zákazníka. Partner znamená značkový portál pro prodejce — stále white-label a chráněný, ale s jinou mapou vlastnictví. Vyberte jedno rozhraní pro první týden.

Sestavení udrží zprávy uvnitř SaaS produktu

Zapojení embed umístí API klíče, klíče idempotence a přijímače webhooků pod inženýrskou organizaci ISV. Akce koncového uživatele se mapují na serverové odesílání s předplacenou peněženkou ISV. Rozhraní SaaS zobrazuje stav nativní pro produkt — v frontě, odesláno, selhalo — nikdy názvy sítí a nikdy druhé přihlašovací údaje pro zákazníka. Dokumentujte, která mikroslužba uchovává produkční klíče.

Partnerský portál zůstává samostatným white-label rozhraním

Partnerské portály slouží správcům prodejců, kteří spravují podnájemce, podíly na sazbách a exporty chráněné značkou. Obrazovky se řídí branami rozhraní Partner: žádné názvy dodavatelů v oznámeních, chybách API, webhookách nebo sloupcích CSV. Živý katalog odpovídá trezoru. Správce partnera není koncovým uživatelem ISV.

Rozdělené vlastnictví: pohled produktu vs. pohled partnera

Rozhodnutí Vkládání (Embed) Partnerský portál
Kdo vidí UI Koncoví uživatelé ISV Správci partnera
Klíče uloženy v Tajnostech ISV Provozním trezoru
Jazyk značky Text produktu SaaS Text white-label partnera
Vlastník deníku Předplacený účet ISV Stejný účet nebo pravidla izolace

Publikujte tabulku v tiketu pro spuštění.

Odmítněte hybridní dema míchající značkové cesty

Tlačítko odeslání v SaaS spolu se snímkem obrazovky partnerského portálu na jednom snímku učí kupující očekávat špatné rozhraní. Pokud kupující vkládá OTP do své aplikace, předveďte embed a články o partnerství ponechte pouze jako doplňkové.

Související provozní cesty

Začněte s IOSOR

Konfigurujte webhookové přijímače svého produktu v konzoli v rámci trezoru tajemství, přičemž klíče API uchovávejte přísně na svém backendovém serveru. Před udělením administrátorského přístupu pro prodejce prosadte ověření na partnerském rozhraní, abyste zajistili, že do datových užitečných zatížení DLR nebo exportů CSV neuniknou žádné značky poskytovatele. Udržujte své produktové rozhraní a partnerské rozhraní oddělené v testovacím i produkčním prostředí.

Shrnutí IOSOR

Integrace zpráv skrze API udržuje veškerý provoz a stavy doručení plně v rozhraní vašeho SaaS produktu, kde jsou řízeny serverovými klíči vašeho týmu. White-label portály naproti tomu slouží výhradně pro administrátory partnerů k řízení struktur podúčtů, cenových marží a exportů bez odhalení infrastruktury. V praxi izolujte API klíče a příjem webhooků přímo v kódové základně produktu. Nikdy nemíchejte administrativní rozhraní partnera s nativními toky zpráv v rámci demo ukázek, protože tyto hybridní přístupy vedou k únikům identity značky a chybám v řízení tenantů.

Byl tento průvodce užitečný?

Související průvodci