Appearance
前端接入
前端接入非常简单，只需要调用两个接口就可以搞定。
在线测试
https://codepen.io/starxg/pen/OJYRgOQ 打开可以看到最简单的实现。
获取微信小程序码
当用户点击某个按钮或者元素时，可以调用此接口获取二维码。
请求方法
GET
请求地址
text
https://api.likexiang.com/openapi/resource/ticket/create?resourceId=资源ID&state=请求体说明
| 参数 | 说明 |
|---|---|
| resourceId | 资源ID。请勿使用他人资源ID否则收益将会计入他人账户中。获取资源ID |
| state | 随机字符串，可以为空 |
响应体
json
{
"ticket": "1FP4e7LIaI",
"qrcode": "base64 图片",
"expire": 1716621125,
"state": ""
}响应体说明
| 参数 | 说明 |
|---|---|
| ticket | 凭证，后续根据这个判断是否扫码 |
| qrcode | 图片二维码，base64 |
| expire | 过期时间，单位秒 |
| state | 用户传入的随机数 |
判断是否获取完毕
获取到二维码图片的同时也得到了 ticket ，可以根据 ticket 判断用户是否获取完毕。
警告
用户应该轮训此接口来判断是否获取资源完毕，建议每秒轮训一次。
当得到 status 是 fetched 或 not_exists 可以结束轮训， fetched 表示用户已经获取完毕可以显示隐藏资源。
fetched 只会返回一次，再次获取会返回 not_exists 。
请求方法
GET
请求地址
text
https://api.likexiang.com/openapi/resource/ticket/status?ticket=凭证响应体
json
{
"status": "fetched",
"timestamp": 1716621195,
"token": "271e8d6e65a33bccf8f9a50246215be6023b597a8575beb4d5a30d4e8a686aec"
}响应体说明
| 参数 | 说明 |
|---|---|
| status | waiting 等待 ；not_exists 不存在；scanned 已经扫码但是没有获取资源；fetched 已经获取到资源 |
| timestamp | 获取资源时间，单位秒 |
| token | 签名，可以判断用户是否真的获取到资源了。如果资源发布者没有设置个人密钥，此值会是：No personal key exists |
提示
如果您的资源不敏感或者不重要，可以省略服务端验证。如果需要服务端验证 token 是否合法请查看 后端接入 。
如果资源发布者没有设置 个人密钥 那么 token 返回的是：No personal key exists