跳到主要内容

客户 / 经纪商

客户 / 经纪商通过托管在 https://manage.iccandle.site/ 的可嵌入 Organization Users（组织用户）面板管理本组织的终端用户。

平台在管理后台创建客户账号、分配唯一 identifier、为积分包充值，再把使用平台共用 API 密钥与该 identifier 的嵌入 URL 交给客户。

生产环境嵌入：

https://manage.iccandle.site/?apikey=YOUR_API_KEY&identifier=YOUR_IDENTIFIER&theme=system&lang=zh&primary=57F63B

Organization Users 嵌入面板：积分包概览与经纪商终端用户列表

如何协同​

  1. 在平台管理后台为客户 / 经纪商创建唯一 identifier 并分配积分包 — 见 为客户充值。
  2. 创建 API 密钥（所有客户共用）— 见 API 密钥。
  3. 把平台 apikey 与该客户唯一的 identifier 交给客户。客户之间通过 identifier 区分，而不是不同的 API 密钥。
  4. 客户在宿主应用中嵌入 https://manage.iccandle.site/（iframe 或独立页面）。
  5. 终端用户通过调用 无缝认证（子组织） 并使用相同的 identifier 挂到该经纪商下。
  6. 经纪商在 Organization Users 面板中为这些用户分配套餐。

面板通过 URL 查询参数完成认证。嵌入内没有单独的登录表单。

嵌入 URL 参数​

参数必需说明
apikey是平台 API 密钥（整个平台一把）。后端请求以 x-api-key 发送。
identifier是该客户 / 经纪商的唯一组织 / 租户 id。在共用密钥下区分客户。允许空格（例如 a broker）。
lang否界面语言：en（默认）或 zh
theme否界面主题：light、dark 或 system（默认）
primary否品牌主色，HEX（RGB、RRGGBB，可选前导 #）。无效值会被忽略。

iframe 示例：

<iframe
  src="https://manage.iccandle.site/?apikey=YOUR_API_KEY&identifier=YOUR_IDENTIFIER&theme=system&lang=zh&primary=57F63B"
  title="Organization Users"
  style="width:100%;height:100%;border:0;"
></iframe>
保护嵌入 URL

apikey 是密钥。建议从已受控的员工页面加载 iframe，避免把有效密钥写进公开文档或工单，URL 泄露后请立即轮换密钥。查询字符串会出现在浏览器地址栏与网络日志中。

缺失或无效凭证​

若 apikey 或 identifier 缺失或格式错误，面板会显示 Missing embed credentials，并列出每个问题（missing / malformed）及简短提示。

期望形态：

/?apikey=YOUR_API_KEY&identifier=YOUR_IDENTIFIER
参数校验
apikey8–128 个字符：字母、数字、_、-、.
identifier2–64 个字符：字母、数字、_、-、.、: 或空格

Organization Users 面板展示内容​

顶栏​

  • 账户名称（有组织余额时取自余额，否则使用 identifier）
  • 语言与主题控件
  • Refresh

积分包（Credit bundle）​

Standard、Pro、Expert 与 TOTAL 的汇总卡片：

指标含义
N left仍可分配的积分
X of Y granted已分配给用户的积分
进度条该档位已授予占比

剩余积分偏低时使用警告样式；耗尽的档位使用破坏性样式。

说明文案示例：12 of 50 credits assigned to your users。

用户表格​

列说明
User显示名称与邮箱
User ID用户 id
Plan当前套餐标签（Standard、Pro、Expert，或 No plan）
Created创建日期（YYYY-MM-DD）
Updated更新日期（YYYY-MM-DD）

窄屏布局（约 760px 以下）下，用户以堆叠卡片展示，而非网格。

搜索、筛选与排序​

  • Search your users — 按名称、平台名、邮箱、用户 id 或子组织名筛选
  • 套餐筛选 — All plans、No plan，或指定档位
  • 点击列头排序（User、User ID、Plan、Created、Updated）
  • 分页：Previous / Next（需要时从服务端加载更多）

为用户分配套餐​

  1. 选择一行用户以打开详情抽屉。
  2. 查看 Current plan（以及可用时的 Last active）。
  3. 在 Assign a plan 下选择 Standard、Pro 或 Expert。无剩余积分的档位会禁用。
  4. 选择 Review assignment to …。
  5. 在 Assign this plan? 中确认 — 对话框会显示套餐变更，并说明将从积分包扣除 一积分。
  6. 选择 Assign plan。

界面强制规则：

  • 分配付费套餐会占用该档位 一积分，只要用户仍停留在该套餐上。
  • 无剩余积分的档位不可选。
  • 若积分包已全部分配完，面板会提示客户联系平台管理员充值。

平台后台：客户 / 经纪商记录​

在管理后台中，平台还会维护客户 / 经纪商账号列表（创建、编辑状态、分配积分包）。该列表与 Organization Users 嵌入相互独立；嵌入只展示属于某一个客户 / 经纪商的终端用户。

另见：

相关指南​