Jika Anda ingin mendapatkan Authorization Token (Access Token) untuk melakukan integrasi API, Anda dapat menggunakan mekanisme berikut :
1. Menggunakan Password.
2. Menggunakan Refresh Token.
1. Password
Melakukan Login dengan menggunakan Password.
Method : POST
API Endpoint : [[baseurl]]/api/integration/v1/login
HEADER
X-TenantID: [[tenantid]]
BODY PAYLOAD (JSON)
{
"username": "[[username]]",
"password": "[[password]]",
"grantType": "password"
}
CONSUME VIA CURL
curl --location --request POST '[[baseurl]]/api/integration/v1/login' \
--header 'X-TenantID: [[tenantid]]' \
--header 'Content-Type: application/json' \
--data-raw '{
"username":"[[username]]",
"password":"[[password]]",
"grantType": "password"
}'
๐Catatan Untuk mengetahui [[baseurl]], [[tenantid]], [[username]], dan [[password]], Anda dapat mempelajarinya pada halaman Integration Credential.
API Response :
{
"access_token": "access token",
"expires_in": 604800,
"refresh_expires_in": 604800,
"refresh_token": "refresh token",
"token_type": "Bearer",
"session_state": "963b2fcf-e016-41c0-9264-b0441bc8355e",
"scope": "gitscope"
}
2. Refresh Token
Melakukan Login dengan menggunakan Refresh Token.
Method : POST
API Endpoint : [[baseurl]]/api/integration/v1/login
HEADER
X-TenantID: [[tenantid]]
BODY PAYLOAD (JSON)
{
"username": "[[username]]",
"grantType": "refresh_token",
"refreshToken": "[[refreshtoken]]"
}
CONSUME VIA CURL
curl --location --request POST '[[baseurl]]/api/integration/v1/login' \
--header 'X-TenantID: [[tenantid]]' \
--header 'Content-Type: application/json' \
--data-raw '{
"username":"[[username]]",
"grantType":"refresh_token",
"refreshToken":"[[refreshtoken]]"
}'
๐Catatan Untuk mengetahui [[baseurl]], [[tenantid]], dan [[username]], Anda dapat mempelajarinya pada halaman Integration Credential. Dan untuk [[refreshtoken]] didapatkan dengan Login menggunakan Password terlebih dahulu.