oAuth 인증

POST /esignglobal/v1/oauth2/accessToken

인터페이스 설명

통과app_id과app_secret인증 획득access_token 구체적인 사용자 신분으로 eSignGlobal API를 요청하는 데 사용되며, 토큰 유효 기간은 24시간입니다.

요청 매개변수

매개변수 이름	유형	필수	설명
client_id	string	true	애플리케이션 계정, 즉 app_id 먼저 eSignGlobal 계정을 등록하고 애플리케이션을 생성한 후 획득하십시오.
client_secret	string	true	애플리케이션 비밀번호, 즉 app_secret 먼저 eSignGlobal 계정을 등록하고 애플리케이션을 생성한 후 획득하십시오.
grant_type	string	true	인증 유형, 지원되는 유형: client_credentials：client_id 및 client_secret을 기반으로 access_token 획득 authorization_code：사용자 인증 절차가 필요합니다(유효 기간은 365일). 인증이 완료되면 access_token 및 refresh_token을 획득할 수 있습니다. refresh_token：인증 유효 기간 내에 refresh_token이 유효한 경우 갱신 작업을 통해 refresh_token의 유효 기간을 연장할 수 있습니다.
code	string	false	인증 코드, 사용자 인증 완료 후 eSignGlobal에서 반환, grant_type이 authorization_code인 경우 필수 전달
refresh_token	string	false	갱신 토큰, grant_type이 refresh_token인 경우에만 갱신 토큰을 제공해야 함

모든 파라미터는 multipart/form-data 양식 형식으로 제출해야 하며 URL 쿼리 파라미터 또는 JSON 요청 본문으로 사용할 수 없습니다.

요청 예시

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

응답 파라미터

파라미터 이름	유형	설명
access_token	string	인증 토큰，인터페이스 요청 인증에 사용되며 유효 기간은 1일입니다.
expires_in	int	토큰 만료까지 남은 시간 (단위: 초)
scope	string	권한 범위 grant_type이 client_credentials인 경우 고정 값 반환:read-write grant_type이 authorization_code 또는 refresh_token인 경우 해당 권한 범위 반환
token_type	string	토큰 유형 고정 값: bearer
refresh_token	string	토큰 갱신에 사용되며 grant_type이 authorization_code 또는 refresh_token인 경우에만 반환됩니다. 유효 기간은 30일이며 만료 후 다시 인증해야 합니다.

응답 예시

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