​
Overview

API token management is a login authentication process that allows a social.plus user to access social.plus applications in a unified and streamlined environment. social.plus SDK provides AmityUserTokenManager to manage user credentials. This includes an access token that can be used to access some Beta features.
Please be aware that we do not provide any API to support the usage of user tokens on the client SDK. To use this user token, you must interact with social.plus Server APIs with your own effort.

​
Create a User Token

To create a new user token, refer to the following example and the parameters below.

​
Parameters

ParameterTypeRequiredDescription
userIdString✅The unique identifier of the user whose credentials are being managed by the AmityUserTokenManager
displayNameString❌The display name of the user. If provided, it will be associated with the user’s credentials
authTokenString❌The user’s authentication token. If provided, it will be used to authenticate the user when accessing the social.plus application

​
Implementation

// 1. create AmityUserTokenManager instance.
let userTokenManager = AmityUserTokenManager(apiKey: "<api-key>", region: .SG)

func createNewUserTokenExample() async {
    // 2. call `createUserToken` on AmityUserTokenManager.
    do {
        let auth = try await userTokenManager.createUserToken(
            userId: "<user-id>",
            displayName: "<(optional)-display-name>",
            authToken: "<(optional)-auth-token>"
        )
        print("auth.accessToken: \(auth.accessToken)")
    } catch {
        print("unable to create a new user token: \(error.localizedDescription)")
    }
}

​
Token Security

​
Best Practices

​
Next Steps

User Authentication

Learn about standard user login and authentication

API Integration

Explore social.plus API documentation