工作原理
当 Nayax 管理员将您的应用添加到菜单时，它会作为 Nayax Core 的原生组件显示给用户。用户打开应用时，Nayax 会向您的应用传递一个包含用户身份和权限的签名 JWT 令牌。您的应用使用该令牌代表已登录用户调用 Nayax API。 Nayax 负责处理：- 在菜单中注册您的应用
- 传递身份验证令牌
- 通过反向代理路由 API 调用
- 跨语言翻译管理
- 控制哪些用户角色可以查看用户界面的哪些部分。
- 构建和托管您的应用程序
- 接收令牌并将其用于 API 调用
- 公开您的 UI 字符串以进行翻译
- 声明哪些 UI 元素可由角色控制
扩展类型
应用在 Nayax Core 中的显示方式取决于 Nayax 管理员配置的显示类型。每种类型控制着布局、导航以及应用接收令牌的方式。- 屏幕——显示整个页面，Nayax Core导航菜单可见。未传递屏幕上下文。
- 全屏模式——不使用 Nayax 菜单，应用提供自定义导航。不传递屏幕上下文信息。
- 带弹出窗口的按钮— 现有屏幕中的按钮，点击后会在模态窗口中打开您的应用。包含屏幕上下文（例如，选定的机器 ID）。
- 标签页— 您的应用将以标签页的形式加载到现有的 Nayax Core 屏幕中。包含屏幕上下文（例如，所选机器 ID）。
全屏扩展程序无法通过 postMessage 接收令牌。如果您的应用使用全屏显示类型，请联系 Nayax 以确认令牌的发送方式。详情请参阅身份验证部分。
你实施的
以下四个领域均设有专门的指南：- 身份验证— 接收并验证 Nayax 在加载时传递的 JWT 令牌。
- 扩展类型— 根据您的使用场景选择合适的显示类型。
- 翻译— 公开您的 UI 字符串，以便 Nayax Core 可以用用户的语言提供它们。
- 基于角色的可见性— 声明管理员可以根据角色显示或隐藏哪些 UI 元素。