概述
快海报提供小程序分享海报生成服务,接口为 HTTP API。
API 接口域名
api.kuaihaibao.com
API 请求 scheme
出于安全考虑,仅支持 https 方式请求,不支持 http 方式
鉴权方式
先在 管理后台 > 开发 > 设置 中点击「Token 启用」
获得 token 后,需要将 token 放入请求 header 的 Authorization
字段中,如下:(把 YOUR_TOKEN_HERE
换成你生成的 token)
Authorization: Bearer YOUR_TOKEN_HERE
永远不要将 Token 存放在任何客户端里
- 容易造成 token 泄漏,造成不必要的金钱损失
- 小程序下载图片一般需要配置
downloadFile
域名,如果小程序中直接调用 API 使用返回我们提供的 URL,我们不保证 URL 的域名不会发生变化。一旦发生变化,您的用户将不能下载图片。所以一定要在您的服务端转存一次图片。如果不慎遗失 token,可选择适当的时间在管理后台重置 token。
注意:重置操作会立刻失效之前的 token,重置不可逆,请谨慎操作。
最佳实践
在你的服务端做 API 请求,把我们返回的图片缓存到自己的服务器(或图片存储服务中)。
不要在客户端直接请求我们的 API,也不要把图片地址直接返回给终端用户。
sequenceDiagram participant 小程序端 participant 服务端 participant 快海报 小程序端->>服务端: 请给我一张分享海报 服务端-->>小程序端: 有缓存,直接返回缓存图片 服务端->>快海报: 无缓存,请求快海报 快海报->>服务端: 返回海报图 服务端-->>服务端: 缓存图片,以备后用 服务端->>小程序端: 返回缓存后的图片
缓存(主动存储快海报生成的分享图)
缓存的优势
提高响应速度,降低响应时间,减少请求快海报的次数(省钱)
何时使用缓存
以小程序生成分享海报为例,以下情况应当使用缓存:
- 生成图片不受生成用户信息影响时
- 生成二维码不带有用户相关的返利、加成、统计信息时
- 生成图片与生成时间无关时
例如:
- 分享不带分享者头像、昵称的图文详情
- 匿名分享一张照片
- 分享无返利效果的电商产品
何时不应缓存
凡是和分享者个人信息有关、和分享时间有关的海报,都不应当缓存,每次生成都需要请求快海报服务。
例如:
- 带分享者头像、昵称、个人信息的图片
- 分享二维码对分享者有返利效果等好处时
- 分享二维码有针对分享者的统计功能时
我们判断这些情况生成的完全相同的海报的概率很小、频率很低,使用缓存反而会使低频资源占据大量存储空间,经济上和效率上都不划算。