Ready Player Me Account
Ready Player Me accounts are accounts of users who created an account at https://readyplayer.me or a subdomain (e.g. https://yoursubdomain.readyplayer.me). Those users want to log in with their credentials and reuse their existing avatars and unlocked assets in your game or app.
Logging user in
First, you send a code to the user's email linked with Ready Player Me:
Initialize the auth process
POST https://api.readyplayer.me/v1/auth/request-login-code
Start the authentication process by sending a code to the user's email.
Request Body
email*
String
Email of the user
The user then uses this code to log in, which returns a user token:
Log user into the Ready Player Me account
POST https://api.readyplayer.me/v1/auth/login
Request Body
code*
String
Pass the code, that the user entered in some input field in your application
This will return you the current state of the user.
Refreshing user token
The previous login response returned the user token and the refresh token. The user token lasts for 15 minutes. After that, you will have to refresh your token to the new token. The following request will return you the new token:
Refresh user token
POST https://api.readyplayer.me/v1/auth/refresh
Request Body
token*
String
Token from user login call
refreshToken*
String
Refresh token from user login call
Start managing your user
Token enables you to start doing the following actions with your user
Last updated