Skip to main content

Auth API

Auth API

login(options)

Performs user login and issues an authentication code.

Options:

ParameterTypeRequiredDescription
timeoutnumber-Timeout (ms)
successfunction-Success callback
failfunction-Failure callback
completefunction-Completion callback

Success Response:

FieldTypeDescription
codestringUser login code (for server authentication)
userIdstringUser unique ID
errMsgstringResult message
TudadaSDK.login({
timeout: 10000,
success: (res) => {
console.log('Login code:', res.code);
console.log('User ID:', res.userId);
// Send code to server to create session
},
fail: (err) => console.error('Login failed:', err.errMsg),
});

checkSession(options)

Checks the validity of the current session.

Options:

ParameterTypeRequiredDescription
successfunction-Success callback (session is valid)
failfunction-Failure callback (session expired)
completefunction-Completion callback
TudadaSDK.checkSession({
success: (res) => console.log('Session valid'),
fail: () => {
console.log('Session expired, re-login required');
TudadaSDK.login({ ... });
},
});

getUserInfo(options)

Retrieves user profile information.

Options:

ParameterTypeRequiredDescription
withCredentialsboolean-Whether to include encrypted data
lang'KO'-Response language
successfunction-Success callback
failfunction-Failure callback
completefunction-Completion callback

Success Response:

FieldTypeDescription
userInfo.nickNamestringNickname
userInfo.avatarUrlstringAvatar image URL
encryptedDatastringEncrypted data (when using withCredentials)
ivstringEncryption initialization vector (when using withCredentials)
signaturestringSignature (when using withCredentials)
rawDatastringRaw data (when using withCredentials)
TudadaSDK.getUserInfo({
success: (res) => {
console.log('Nickname:', res.userInfo.nickName);
console.log('Avatar:', res.userInfo.avatarUrl);
},
});

// With encrypted data
TudadaSDK.getUserInfo({
withCredentials: true,
success: (res) => {
// Send encryptedData, iv to server for verification
sendToServer(res.encryptedData, res.iv);
},
});