# sign_in

# Function

Function Name Description Level
sign_in Sign in with tapatalk id. When the account does not exist, register one first. Controlled by flag 'sign_in' returned in get_config.

Input Parameters:

Name Type Required? Description Level
token String yes login with tapatalk id will get the token
code String yes md5 of fid, tapatalk id join email of tapatalk id, sample: md5('123|1234|xxxx@gmail.com')
email byte[] email of the account you'll be sign in. When you are sure the account already exists and want to sign in directly, provide email with token and code, don't need username and password
username byte[] username of the account you'll be sign in. When you are sure the account already exists and want to sign in directly, provide username with token and code, don't need email and password
password byte[] Provide password if you want to register an account before sign in. In this case you need provide all five parameters.

Output Parameters:

Name Type Required? Description Level
status String For account register, '1' means username was occupied, '2' means app need ask for username from user, '3' means the email of the account app request to login does not match with tapatalk id email, and others are of no concern. Other response fields are the same as plugin function login
register Boolean Indicate it's a new register or just a login. True for new register.
preview_topic_id String Some forums require new registered user to read a preset topic before he can do any other actions in the forum. Then return the topic id here. App will jump to the topic after registration.
Array of Hash table yes The response structure is the same as function login