集成接入流程

闪闪编辑器支持第三方应用集成，您可以通过后端接口和前端嵌入的方式，此文档主要介绍接入流程和参数设置说明，api说明及使用详见文档

申请账号

点击 闪闪编辑器-应用申请，填写基本信息后，会有运营和您联系，开通应用账号。具体操作如下图：

账号开通之后，点击 闪闪编辑器-应用管理，进入系统。

1、主页

• 展示集成用户数据总览，主要包括近期模板数据，用户数据。

2、展示设置

• 品牌 logo：将您的网站 logo 显示在闪闪编辑器编辑界面的左上角。

如果不配置此项，将会默认显示闪闪编辑器的 logo

此参数在调用 /access/email 接口时也可以传入，以接口传入参数为准。如截图中序号1

• 品牌Icon：网站标签页图标，如截图中序号2

• 顶栏背景色：编辑器中顶栏背景色，如截图中序号3

• 顶栏文字颜色：编辑器中顶栏文子颜色，如截图中序号4

设置动态展示效果

3、开发设置

• Push URL：您的用户所编辑的邮件内容会“实时”的推送给这个接口地址。由您进行鉴权（是否由闪闪推送）、校验（内容是否被篡改）之后解析并存储。

• Push Key：闪闪会生成密钥对。在推送数据时，闪闪会用公钥加密，您使用私钥解密。

• Return URL：您的用户编辑完邮件之后，点击“返回”按钮时，页面所跳转页面的路径

4、访问域名

域名设置分3种方式

4.1默认域名

• https://www.shanedit.com 无须额外配置，直接用此域名调用即可，以编辑邮件为例，跳转地址：

  xxxxxxxxxx
  <a href="https://www.shanedit.com/thirdApp?code=$code&id=$id" target="_blank">编辑邮件</a>
  

4.2子域名

• 举例：https://abc.shanedit.com 在【访问域名】菜单中，添加 abc.shanedit.com 域名即可，以编辑邮件为例，跳转地址：

  xxxxxxxxxx
  <a href="https://abc.shanedit.com/thirdApp?code=$code&id=$id" target="_blank">编辑邮件</a>
  

4.3自定义域名

• 举例：https://abc.xyz.com

自定义域名相对复杂一点，分为以下步骤：

1. 域名abc.xyz.com 协议必须是https且装了有效的ssl证书， 即：https://abc.xyz.com

2. 域名（https://abc.xyz.com）必须是经过ICP备案

3. 向闪达申请将域名（https://abc.xyz.com）添加到闪达这边的UCloud白名单

4. 闪达这边向闪闪编辑器的数据库中加入该域名（https://abc.xyz.com）记录

以编辑邮件为例，跳转地址：

xxxxxxxxxx
<a href="https://abc.xyz.com/thirdApp?code=$code&id=$id" target="_blank">编辑邮件</a>

5、编辑设置

• 编辑器中邮件模板变量符号设置

【编辑设置】中变量格式设置“%”后，邮件模板的全局设置参数中变量格式会读取设置的“%”符号，如下图所示：