회원 JWT

장바구니·마이페이지·주문 내역처럼 구매자 본인​​의 데이터를 다루는 API 는 프로젝트 인증(Basic)에 더해 회원 JWT 를 받습니다.

Authorization: Basic base64(clientKey:secretKey)
Bootpay-User-JWT: <회원 로그인 시 받은 JWT>

받는 방법

회원 로그인 API(POST /v1/users/login, 서버용 POST /v1/users/login/token)가 응답으로 JWT 를 돌려줍니다. 가입 API 는 JWT 를 주지 않으므로 가입 후 로그인을 한 번 더 합니다. 자세한 내용은 회원 문서를 봅니다.

JWT 와 user_id

인증 절에 회원 JWT 만 적힌 API 는 JWT 가 가리키는 회원으로 처리합니다.

인증 절에 JWT 또는 user_id 로 적힌 API 는 둘 중 하나만 보내면 됩니다.

  • 둘 다 보내면 JWT 가 우선입니다. user_id 가 JWT 와 다른 회원을 가리키면 403 USER_NOT_MATCH 로 거절합니다.
  • user_id 는 secretKey 인증(Basic·Bearer)일 때만 받습니다. 규칙은 인증 — 호출 구조를 봅니다.

예외로 GET·DELETE /v1/users/session 은 대상이 회원이 아니라 "이 JWT 세션"이라 JWT 전용​​입니다. user_id 계열 키를 보내면 400 API_PARAM_INVALID 로 거절합니다.

회원 JWT 를 쓰지 않고 user_id 로만 회원을 받는 API 도 있습니다. 어느 쪽이든 값은 쇼핑몰 서버가 자기 로그인 세션에서 꺼내 넣습니다.

필수 / 선택

각 엔드포인트 문서의 인증 절에 표시합니다.

  • 필수​: JWT 가 없거나 유효하지 않으면 401 로 거절합니다.
  • 선택​: JWT 가 있고 유효하면 회원 기준 정보(예: 내가 누른 도움돼요)를 채우고, 없거나 무효면 비회원으로 처리합니다. 오류를 내지 않습니다. 무효 JWT 와 함께 user_id 를 보냈으면(secretKey 인증) 비회원 대신 그 회원으로 처리합니다.

오류 (필수인 API)

HTTP error_code 언제
401 USER_SESSION_INVALID 헤더가 없음, 로그아웃·만료·탈퇴한 세션, 다른 프로젝트의 회원
401 USER_JWT_INVALID 서명이 맞지 않거나 변조됐거나 만료된 JWT
403 USER_NOT_MATCH JWT 와 user_id 를 함께 보냈는데 서로 다른 회원

USER_JWT_INVALID 를 받으면 다시 로그인해 새 JWT 를 받으세요.

함께 보기