智能表单文档

Appearance

快速接入 ​

5 分钟跑通最小接入：换取 Token → 拉取已发布项目表 → WebView 打开表单。

接口域名（API_ORIGIN）与表单地址以你的部署环境为准，可在 API开放平台 控制台顶部查看。下文用 https://your-domain.com 占位。

前置条件 ​

  • 在 项目管理器 · 开放平台 或 API开放平台「密钥管理」生成一个 API-Key（通常以 sk- 开头）。
  • 已有至少一个 已发布 的项目表。

第 1 步：换取 access_token ​

bash
curl -X POST "https://your-domain.com/api/v1/apihub/apikeys/token" \
  -H "X-API-Key: sk-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "client_user_id": "10001" }'

成功返回中取 data.access_token，后续接口用它做 Bearer 鉴权。详见 鉴权。

第 2 步：拉取已发布项目表 ​

bash
curl "https://your-domain.com/api/v1/apihub/projects/published-list?limit=20" \
  -H "Authorization: Bearer <access_token>"

从返回的 list[] 中读取每个项目表的 short_code。

第 3 步：在 WebView / iframe 打开表单 ​

用上一步拿到的 short_code 和 access_token 拼出填表地址，在你的 App（WebView）或网页（iframe）中打开：

text
https://<表单域名>/{short_code}?token={access_token}

short_code 放在路径上，token 放在 query 上，均建议 URL 编码。实际表单域名以控制台「表单项目地址」为准。

可选：积分充值（付费场景） ​

若项目配置了发布扣费、解锁扣费等，终端用户需持有积分。典型流程：

  1. 开发者在 APIHub 控制台「充值」页为积分池充值
  2. 用户在你的 App 内支付后，你的服务端调用 POST /apihub/points/users/recharge 给用户入账
  3. 用户打开表单时，平台从该用户积分中扣费

详见 API 参考 · 积分。

下一步 ​