海报设计器接入文档

<!-- 1. 引入 SDK（也可使用您部署的同源地址） -->
<script src="https://your-webapi.com/poster/poster-generator-umd.js"></script>

<button onclick="openPosterDesigner()">打开设计器</button>

<script>
  function openPosterDesigner() {
    PosterGenerator.openDesigner({
      // === 必填 ===
      token:      'a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6',
      // === 可选：编辑已有海报时填入 ===
      posterId: '',
      // === 可选：画布初始尺寸（仅未传 posterId 创建新海报时生效，默认 375 × 667） ===
      width:  375,
      height: 667,
      // === 可选：数据源字段（设计器中文本可绑定） ===
      dataSourceFields: {
        userName: '用户姓名',
        phone:    '手机号码',
        orderNo:  '订单号'
      },
      // === 海报初始化结果回调 ===
      onPosterReady: function (posterId, error) {
        if (error) {
          console.error('海报初始化失败:', error);
          // 处理错误（如提示用户重试）
          return;
        }
        console.log('海报已就绪，posterId:', posterId);
        // 将 posterId 保存到您的业务系统（如关联到订单、用户记录等）
        // 例如: saveToMyBackend(posterId);
      }
    }).then(({ window: w }) => {
      console.log('设计器已就绪，等待海报初始化...');
    }).catch(err => {
      // err.code: INVALID_PARAMS / POPUP_BLOCKED / TIMEOUT / SEND_FAILED
      alert('[' + err.code + '] ' + err.message);
    });
  }
</script>

<script src="https://your-webapi.com/poster/poster-generator-umd.js"></script>

<img id="poster-preview" alt="预览" />

<!-- 同源部署：直接相对路径引入即可 -->
<script src="/poster/poster-generator-umd.js"></script>
<script>
  PosterGenerator.render({
    token:    'a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6',
    posterId: 'a1B2c3D4e5F6g7H8i9J0kLmNoPqRsTuV',
    dataSourceValues: {
      userName: '张三',
      phone:    '138****8888',
      orderNo:  'ORD20260516001',
      amount:   '￥199.00'
    }
  }).then(function (dataUrl) {
    document.getElementById('poster-preview').src = dataUrl;
  }).catch(function (err) {
    console.error('海报渲染失败：', err.message);
  });
</script>

<button onclick="downloadPoster()">生成并下载海报</button>

<script>
  async function downloadPoster() {
    try {
      // 1. 渲染海报
      const dataUrl = await PosterGenerator.render({
        token:    'a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6',
        posterId: 'a1B2c3D4e5F6g7H8i9J0kLmNoPqRsTuV',
        dataSourceValues: { userName: '张三', phone: '138****8888' }
      });

      // 2. 下载海报（文件名不传 → 自动 poster.jpg）
      PosterGenerator.downloadImage(dataUrl);

      // 也可以指定文件名（不含扩展名会自动追加）
      // PosterGenerator.downloadImage(dataUrl, '订单详情_' + Date.now());
    } catch (err) {
      console.error('下载失败：', err.message);
    }
  }
</script>

{
  "token": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
  "posterId": "a1B2c3D4e5F6g7H8i9J0kLmNoPqRsTuV"
}

{
  "success": true,
  "message": "已删除"
}

// Token 无效或类型不匹配
{ "success": false, "message": "Token 无效或已过期" }

// 海报不存在
{ "success": false, "message": "海报不存在或已被删除" }

// 无权删除（海报不属于该 Token 关联的账号）
{ "success": false, "message": "无权删除该海报" }

curl -X POST https://your-webapi.com/api/poster/delete \
  -H "Content-Type: application/json" \
  -d '{
    "token": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "posterId": "a1B2c3D4e5F6g7H8i9J0kLmNoPqRsTuV"
  }'