Versions Compared

Version Old Version 20 New Version 21
Changes made by

Que Nguyen

Que Nguyen

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Table of Contents
stylenone

Changelogs

Version

Date

Changes by

Description of change

V1.0

Mar 29, 2024

Que Nguyen

  • Add Table of Contents.

  • Add Changelogs.

V1.0.1

April 10, 2024

Que Nguyen

  • Add Release Status table.

  • Update RefreshToken into Response.Data

Release Status

Environment

Status

Released Date

Version

DEV

Status
colourGreen
titleReleased

April 10, 2024

V1.0.1

UAT

Status
colourGreen
titleRELEASED

April 17, 2024

V1.0.1

PROD

Status
colourGreen
titleRELEASED

Mar 25, 2024

V1.0

API Definitions

Get Access

The Token

Resource information

Response format(s)

JSON

Requires authentication?

No

Request Header

Name

Value

Content-Type

application/json

Request Body

ApiKey

  • required

  • string(36)

API key value associate with a User + Business Account

GrantType

  • required

  • string

api_key

ClientId

  • required

  • string(36)

System / App / Platform unique identifier

ClientSecret

  • required

  • string(36)

System / App / Platform secret

Returns

Returns a message with status code.

Response Header

Content-Type

application/json

Response Body

Field

Type

Description

AccessToken

string

resource

The primary resource that you will be interacting with when retrieving the authorization token.

AccessToken text

User access token

Token

life time

lifetime: https://redex-eco.atlassian.net/wiki/spaces/PAD/pages/286490675/Authentication#Access-Token%3A

RefreshToken text

string

User refresh token. Using in API “GET Refresh Token”

Token

life time

lifetime: https://redex-eco.atlassian.net/wiki/spaces/PAD/pages/286490675/Authentication#Refresh-Token%3A

ExpiresIn

string

int

Token’s expired time in second

TokenType

text

Type Identifier: Bearer

Scope text

string

Collection of scopes granted for this user access token.

Request

Code Block
languagejson
{
  "AccessToken": "{{AccessToken}}",
  "RefreshToken": "{{RefreshToken}}",
  "ExpiresIn": "3600",
  "TokenType": "Bearer",
  "Scope": "REConnect_api REDEX_api REHash_api"
}

API Definitions

Status
colourGreen
titlePOST
/public/v2/connect/token

Body

Code Block
languagejson
{

Request Header

Content-Type

application/json

Request Payload

ApiKey (required) text

API key value associate with a User + Business Account

Max length: 36

GrantType (required) text

Grant type: api_key

ClientId (required) text

System / App / Platform unique identifier

Max length: 36

ClientSecret (required) text

System / App / Platform secret

Max length: 36

Code Block
curl -X POST 'https://uat-api.redex.eco/public/v2/connect/token' \
-H 'Content-Type: application/json' \
-D '{
    "ApiKey": "4d7869f0-71cc-43d8-8b82-1f87db6eda2f",
    "GrantType": "api_key",
    "ClientId": "3Yj1rQvcDGYXqXtaxDNyWaNkWPUAwJ",
    "ClientSecret": "fNDq3vGM26wzOqr9OMUXQkxdG5J3$o"
}'

Response

Response Body

Data object

Return Token Resource above

返回上面的Token资源

Errors list of error objects

Please see "Getting Started - #Error Object" for more details

请查看Getting Started - #Error Object以获得更多信息。

Meta null object

Return null object

StatusCode integer

Http Status codes standard. Example 200, 201, 404.

http状态码，如200，201，404

Message text

Response message: Success or error message.

返回成功或错误的信息。

Info

200 Success

Code Block
languagejson
{
    "Data": {
        "AccessToken": {{AccessToken}},
        "RefreshToken": {{RefreshToken}},
        "ExpiresIn": "3600",
        "TokenType": "Bearer",
        "Scope": "REConnect_api REDEX_api REHash_api"
    },
    "Errors": null,
    "StatusCode": 200,
    "Message": "Return tokens successfully",
    "Meta": null
}

Warning

400 401 Unauthorized

Code Block
languagejson
{
    "Data": null,
    "Errors": [
        {
            "Key": "unsupported_grant_type",
            "Message": "unsupported_grant_type"
        }
    ],
    "StatusCode": 400401,
    "Message": "unsupported_grant_type",
    "Meta": null
}