为了给用户提供授权访问,您的应用程序应该从 /users 端点获得一个用户 token( 链接 token )。这是一个一次性的、短暂的 token ,用于初始化我们的 Wink Widget 。
过期时间在 token 生成时就被包含在内。您还可以在 token 过期时监听 SDK 的事件(见下文)。
您的服务器或应用程序应该在每次启动 Wink Widget 时为用户生成一个新的链接 token 。
刷新一个用户的 token
可以通过调用 /tokens
端点来刷新用户的 token 。只需在查询中将用户的 userId
作为参数,您就可以给用户一个新的 token 。
Token 对象
属性 | 类型 | 详情 |
---|---|---|
expiresAt | date-time | token 将要过期的时间 |
mode | string | 链接 token 的有效模式,可以是 SANDBOX 或 PRODUCTION 。 |
accessToken | string | 启动链接流的短暂标志 |
Token 数据样本
{
"expiresAt": "2022-11-01T09:00:00Z",
"mode": "SANDBOX",
"accessToken": "abcdefghijklmnopqrstuvwxyz.ABCDEFGHIJKLMNOPQRSTUVWXYZ-0123456789zyxwvutsrqponmlkjihgfedcbaZYXWVUTSRQPPONMLKJIHGFEDCBA.0987654321abcdefghijklmnopqrstuvwxyz.ABCDEFGHIJKLMNOPQRSTUVWXYZ-0123456789zyxwvutsrqponmlkjihgfedcbaZYXWVUTSRQPPONMLKJIHGFEDCBA.0987654321abcdefghijklmnopqrstuvwxyz.ABCDEFGHIJKLMNOPQRSTUVWXYZ-0123456789zyxwvutsrqponmlkjihgfedcbaZYXWVUTSRQPPONMLKJIHGFEDCBA.0987654321abcdefghijklmnopqrstuvwxyz.ABCDEFGHIJKLMNOPQRSTUVWXYZ-0123456789zyxwvutsrqponmlkjihgfedcbaZYXWVUTSRQPPONMLKJIHGFEDCBA.0987654321abcdefghijklmnopqrstuvwxyz.ABCDEFGHIJKLMNOPQRSTUVWXYZ-0123456789zyxwvutsrqponmlkjihgfedcbaZYXWVUTSRQPPONMLKJIHGFEDCBA.0987654321abcdefghijklmnopqrstuvwxyz.ABCDEFGHIJKLMNOPQRSTUVWXYZ-0123456789zyxwvutsrqponmlkjihgfedcbaZYXWVUTSRQPPONMLKJIHGFEDCBA.0987654321abcdefghijklmnopqrstuvwxyz.ABCDEFGHIJKLMNOPQRSTUVWXYZ-0123456789zyxwvutsrqponmlkjihgfedcbaZYXWVUTSRQPPONMLKJIHGFED"
}
端点
端点 | |
---|---|
刷新 token | POST /tokens |
Webhooks
USER_CREATED
USER_CREATED
当一个新的用户在 Smile Network 中被创建,并且他们的链接 token 可用时,此 Webhook 事件会被触发。
{
"id": "et-123abc456def789abc123def456abc78",
"version": 1,
"type": "USER_CREATED",
"createdAt": "2021-04-14T09:30:24Z",
"data": {
"userId": "tenantId-123abc456def789abc123def456abc78"
}
}
事件监听器
SDK 还可以发出特定的事件,该事件可被您的本地应用程序捕获,以便应用程序根据需要作出反应和执行功能。
回调 | 数据 | 详情 |
---|---|---|
onTokenExpired | - | 当链接 Token 过期时被触发。 |