액세스 토큰 발급 (레거시)

Authorization: Bearer <access_token> 방식에 쓰는 토큰을 발급합니다. 기존 연동 호환용으로만 남아 있습니다.

신규 연동에는 쓰지 마세요. 모든 v1 API 는 요청마다 Authorization: Basic base64(clientKey:secretKey) 로 호출할 수 있습니다. 토큰을 발급·갱신·보관할 필요가 없습니다. 자세한 내용은 인증을 봅니다.

POST /v1/request/token

액세스 토큰을 발급합니다. 같은 키로 발급한 유효한 토큰이 있고 만료까지 5분 넘게 남았으면 그 토큰을 그대로 돌려주고, 없거나 5분 이내로 남았으면 새로 발급합니다. 토큰 유효 시간은 발급 시각부터 30분입니다.

인증

둘 중 하나로 인증합니다.

  • Authorization: Basic base64(clientKey:secretKey) — 인증
  • (레거시) Authorization 헤더 없이 본문에 server_key·private_key

필요한 scope: scope 검사 없음. 회원 JWT(Bootpay-User-JWT): 필요 없음.

요청

위치 이름 타입 필수 기본값 설명
body server_key string 헤더 없을 때 O (레거시) 서버 키
body private_key string 헤더 없을 때 O (레거시) 프라이빗 키

응답

200 OK

{
  "expire_in": 1800,
  "access_token": "3f9a..."
}json
필드 타입 설명
access_token string Authorization: Bearer 에 넣을 토큰
expire_in integer 만료까지 남은 초. 기존 토큰을 돌려줄 때는 1800 보다 작습니다

만료된 토큰으로 호출하면 404 TOKEN_NOT_FOUND 가 옵니다. expire_in 이 지나기 전에 다시 발급받으세요.

오류

HTTP error_code 언제
404 PROJECT_SERVER_KEY_INVALID server_key 가 없거나 없는 키
401 PROJECT_PK_INVALID private_key 불일치

Basic 인증 오류·IP 차단·이용 중지 오류는 인증을 봅니다.

변경 이력

  • 2026-09-23 문서 최초 작성

함께 보기