Obtain Access Token

Obtaining an accessToken for MAVI-API requests is essential. This API also provides a refreshToken to obtain a new accessToken if the current one expires. The default expiration time for accessToken is 4 hours. Both accessToken and refreshToken will be sent through callback URI provided in the request.

Host URL

• https://mavi-backend.memories.ai

Endpoint

POST auth/api/token/getAccessToken

• Rate limit: 50 requests per day.
  • accessToken: Valid for 2 hours, used for API authentication.
  • refreshToken: Valid for 2 months, used to renew the accessToken.

Request Body            

{
  "clientId": "myxjDRvjN+osYha2DxNAuVlYVnpY26BU2pPJdCyVzJU=",
  "code": "xxxxxx"
}

Request Parameters            

Name	Location	Type	Required	Description
body	body	object	No	Request payload
» clientId	body	string	Yes	Client ID
» code	body	string	Yes	Callback code

Response Example            

Status code 200 OK

{
  "code": "string",
  "msg": "string",
  "data": {
    "accessToken": "string",
    "type": "string",
    "expiresIn": 0,
    "refreshToken": "string",
    "refreshExpiresIn": 0
  }
}

Response Structure            

Name	Type	Required	Description
code	string	Yes	Status code
msg	string	Yes	Message
data	object	Yes	Data object
» accessToken	string	Yes	Access token
» type	string	Yes	Token type
» expiresIn	integer	Yes	Token expiration time
» refreshToken	string	Yes	Refresh token
» refreshExpiresIn	integer	Yes	Refresh token expiration time