개발자센터
V1
V2
파트너 정산 릴리즈 노트 기술 블로그

인증 관련 API

인증에 관련된 API 를 확인할 수 있습니다.

⌨ API Key 방식으로 로그인

POST https://api.portone.io/login/api-key

API Key 방식 로그인

API key 를 통해 API 인증에 사용할 토큰을 가져옵니다.

Parameters

Body

apiKey*
string

사용자의 API Key

Responses

200
로그인 성공 응답

accessToken * string

인증에 사용하는 엑세스 토큰. 하루의 유효기간을 가지고 있습니다.


refreshToken * string

토큰 재발급 및 유효기간 연장을 위해 사용하는 리프레시 토큰. 일주일의 유효기간을 가지고 있으며, 리프레시 토큰을 통해 유효기간이 연장된 새로운 엑세스 토큰을 발급받을 수 있습니다.


400
요청된 입력 정보가 유효하지 않은 경우. 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.'

type * string

"INVALID_REQUEST"


message string

에러 메시지


401
인증 정보가 올바르지 않은 경우

type * string

"UNAUTHORIZED"


message string

에러 메시지


⌨ 토큰 재발급

POST https://api.portone.io/v2/token-regeneration

토큰 재발급

리프레시 토큰을 이용한 토큰 재발급

Parameters

Body

refresh_token*
string

새로운 token을 발급받기 위한 refresh token

Responses

200
토큰 재발급 응답

access_token * string

인증 서버에서 인증된 사용자의 access token


refresh_token * string

인증 서버에서 인증된 사용자의 access token


401
유효하지 않은 refresh token

code * string

에러 코드


params * object

에러 세부사항

params

message string

에러 메시지



500
서버 에러

code * string

에러 코드


params * object

에러 세부사항

params

message string

에러 메시지



⌨ API Key 방식으로 로그인 (Deprecated)

POST https://api.portone.io/v2/signin/api-key

API Key 방식으로 로그인

API Key 방식으로 로그인

Parameters

Body

api_key*
string

사용자의 API Key

Responses

200
로그인 성공

access_token * string

인증 서버에서 인증된 사용자의 access token


refresh_token * string

인증 서버에서 인증된 사용자의 access token


401
인증 실패

code * string

에러 코드


params * object

에러 세부사항

params

message string

에러 메시지



500
서버 에러

code * string

에러 코드


params * object

에러 세부사항

params

message string

에러 메시지