Awtorisasyon ng oAuth

POST /esignglobal/v1/oauth2/accessToken

Paglalarawan ng Interface

Sa pamamagitan ngapp_idatapp_secretkunin ang pagpapatunay (authentication)access_token , na ginagamit upang humiling ng eSignGlobal API bilang isang partikular na user. Ang bisa ng Token ay 24 oras.

Mga Parameter ng Kahilingan

Pangalan ng Parameter	Uri	Kinakailangan	Paglalarawan
client_id	string	true	Application account, i.e. app_id Mangyaring magrehistro muna ng eSignGlobal account at lumikha ng application upang makuha ito.
client_secret	string	true	Application password, i.e. app_secret Mangyaring magrehistro muna ng eSignGlobal account at lumikha ng application upang makuha ito.
grant_type	string	true	Uri ng Awtorisasyon, suportado ang mga sumusunod na uri: client_credentials:Batay sa client_id at client_secret para makakuha ng access_token authorization_code:Kailangan ng partisipasyon ng user sa proseso ng pagpapahintulot (may bisa sa loob ng 365 araw). Pagkatapos ng pagpapahintulot, makakakuha ng access_token at refresh_token refresh_token:Sa loob ng panahon ng pagpapahintulot, at kung ang refresh_token ay may bisa pa, maaaring pahabain ang bisa ng refresh_token sa pamamagitan ng pag-refresh
code	string	false	Authorization code, ibinalik ng eSignGlobal pagkatapos ng pahintulot ng user, kinakailangan kapag ang grant_type ay authorization_code
refresh_token	string	false	I-refresh ang token, kailangan lamang magbigay ng refresh token kapag ang grant_type ay refresh_token

Lahat ng parameter ay dapat sa pamamagitan ng multipart/form-data na format ng form, hindi maaaring gamitin bilang URL query parameter o JSON request body.

Halimbawa ng kahilingan

curl --location 'http://………………/esignglobal/v1/oauth2/accessToken' \
--form 'client_id="LZn…………g89"' \
--form 'client_secret="5ugL0rM………………Yne7b"' \
--form 'grant_type="client_credentials"' \

Mga parameter ng tugon

Pangalan ng parameter	Uri	Paliwanag
access_token	string	Token ng Pagpapatunay，Ginagamit para sa pagpapatunay ng kahilingan sa interface, ang bisa ay 1 natural na araw
expires_in	int	Ang natitirang oras bago mag-expire ang Token, yunit: segundo
scope	string	Saklaw ng Pahintulot Kapag ang grant_type ay client_credentials, ibinabalik ang nakatakdang halaga:read-write Kapag ang grant_type ay authorization_code o refresh_token, ibinabalik ang kaukulang saklaw ng pahintulot
token_type	string	Uri ng Token Nakatakdang halaga: bearer
refresh_token	string	Ginagamit upang i-refresh ang token, ibinabalik lamang kapag ang grant_type ay authorization_code o refresh_token, ang bisa ay 30 natural na araw, kailangang pahintulutan muli pagkatapos mag-expire

Halimbawa ng Tugon

{
    "access_token": "eyJhbGciOiJIUzI1N………………th1pMM3oYk",
    "expires_in": 86398,
    "scope": "read-write",
    "token_type": "bearer"
}