RetailysBusiness Platform
v2.0.0-stable
IAM App Registry · RegisteredApp

🔌 Registrace aplikace
do RBP platformy

Jak zaregistrovat novou aplikaci, získat OAuth2 credentials a integrovat ji pod Retailys Business Platform pomocí transparentního proxy a x-rbp-* vendor extensions.

🏗️
KROK 1 Z 5

Připrav svoji aplikaci

Tvoje aplikace musí mít veřejně dostupné OpenAPI 3.1 schema a HTTP endpoint pro proxy.

Veřejná URL s OpenAPI 3.1 specifikací (JSON nebo YAML)
HTTP endpoint dostupný z RBP API Gateway (nebo VPN)
Bearer token autentizace — platforma předá token 1:1
Definovaný slug (URL segment, např. helloworld)
Volitelně: x-rbp-* vendor extensions v OpenAPI spec pro integraci UI
Tvoje OpenAPI spec (minimální příklad)yaml
openapi: 3.1.0
info:
  title: HelloWorld API
  version: 1.0.0
  x-rbp-app:
    treeNodeId: helloworld
    type: admin
    theme:
      palette:
        primary: '#2563EB'
servers:
  - url: https://chat.sandbox.retailys.com
paths:
  /conversations:
    get:
      operationId: listConversations
      tags: [Conversations]
      x-rbp-resource:
        label: Konverzace
        labelPlural: Konverzace
        icon: MessageChatSquare
        displayField: subject
      responses:
        '200':
          description: OK