Tokens

为了给用户提供授权访问,您的应用程序应该从 /users 端点获得一个用户 token( 链接 token )。这是一个一次性的、短暂的 token ,用于初始化我们的 Wink Widget

过期时间在 token 生成时就被包含在内。您还可以在 token 过期时监听 SDK 的事件(见下文)。

您的服务器或应用程序应该在每次启动 Wink Widget 时为用户生成一个新的链接 token 。

刷新一个用户的 token

可以通过调用 /tokens 端点来刷新用户的 token 。只需在查询中将用户的 userId 作为参数,您就可以给用户一个新的 token 。

Token 对象

属性类型详情
expiresAtdate-timetoken 将要过期的时间
modestring链接 token 的有效模式,可以是 SANDBOXPRODUCTION
accessTokenstring启动链接流的短暂标志

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"
}

端点

端点
刷新 tokenPOST /tokens

Webhooks

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 过期时被触发。