0. 인증 토큰 발급

개요

핑거푸시 비즈메시지 Server to Server API 호출 시, 권한 인증을 위한 JWT 토큰을 발급합니다.

이때 발급된 토큰은 발급 시간으로부터 최대 10시간까지 유효하며, 이후 Server to Server API 호출 시 Authorization header에 발급된 토큰을 포함하여 호출합니다.

API Server URL: https://bizmsgapi.fingerpush.com/rest/auth/v1/getToken

---

발송 방법 및 전송/수신 파라미터 정의

HTTPS Headers

파라미터명	필수 여부	설명
Content-Type	필수	application/json

HTTPS Parameters

SSL Protocol을 이용하여 파라미터들을 핑거푸시 Server to Server API Server(이하 API Server)에 전달합니다.

필수 값을 제외한 옵션값들에 대해서는 파라미터가 전달되지 않을 경우 기본값으로 처리됩니다.

API Server로 전달해야 할 파라미터들은 아래 표를 참조해 주세요.

[표 1.1] 토큰 발급 HTTPS, Parameters

파라미터명	필수 여부	Byte 수	설명
userId	필수	50	핑거푸시 사용자 ID
customerKey	필수	-	핑거푸시 customer Key

Request JSON Sample

{
  "userId": "fp_user_01",
  "customerKey": "ABCDE12345FGHIJ67890KLMNO12345PQ"
}

Response JSON

API 서버에서 전달 받은 파라미터 처리 후 결과를 JSON 형태로 제공합니다.

{
  "code": "200",
  "message": "",
  "data": {
    "token": "eyJhbGciOiJIUzI1NiJ9.eyJ0b2tlbiI6Ii4uLiIsImlhdCI6MTc3MDA4MDgwNywiZXhwIjoxNzcwMTE2ODA3fQ.fFKBbFpIsgXXXX"
  }
}

[표 1.2] 발송 JSON 결과

값	설명
code	결과 코드
message	결과 메시지
data	결과 데이터 JSON
data.token	생성된 JWT 토큰

처리결과에 따른 result 값은 아래와 같습니다.

[표 1.3] 발송 JSON 결과의 result code 유형

코드	내용	비고
200	정상처리 됨
503	필수 값 없음
4031	Biz Message 이용 권한 없음	계정 존재 여부
4032	Biz Message 이용 권한 없음	계정 서비스 권한 여부
5301	DB INSERT 중 에러
5302	토큰 값 생성 중 에러
5303	토큰 생성 실패