액세스 토큰 발급

📘 개발 가이드

액세스 토큰 발급

API를 사용하기 위해서는 액세스 토큰을 포함하여 요청해야 합니다. Client Credentials 방식으로 액세스 토큰을 발급받는 절차를 안내합니다.

ℹ️

토큰 사용 제한

토큰 요청은 shop_uid(상점 ID)와 요청 IP의 조합 단위로 제한됩니다.

각 조합별로 1분당 최대 5회 요청할 수 있으며, 발급된 토큰의 유효 시간은 5분입니다.

요청 방식

항목	내용
Method	POST
URL	https://connect.makeshop.co.kr/oauth/token
Content-Type	application/x-www-form-urlencoded

토큰 Request

curl -X POST 'https://connect.makeshop.co.kr/oauth/token' \
  -H 'Authorization: Basic {base64_encode({client_id}:{client_Secret})}' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'grant_type=client_credentials' \
  -d 'shop_uid={상점Id}'

Request 파라미터

파라미터	필수 여부	설명
grant_type	필수	client_credentials로 입력해 주세요.
shop_uid	필수	요청 API의 Owner 상점 ID를 입력해 주세요.

토큰 Response

토큰 발급에 성공할 경우 다음과 같은 response를 확인할 수 있습니다.

HTTP/1.1 200 OK
{
  "success": true,
  "operation": "token.token",
  "code": "OK",
  "message": "요청이 성공적으로 처리되었습니다.",
  "data": {
    "access_token": "eyJhb...",
    "token_type": "Bearer",
    "expires_in": 300
  }
}

Response 파라미터

파라미터	설명
success	요청 성공 여부
operation	수행된 API 작업 식별자
code	응답 코드 (예: OK, ERROR 등)
message	응답 메시지
data	응답 데이터
data.access_token	인증에 사용되는 액세스 토큰
data.token_type	인증 타입
data.expires_in	토큰 만료 시간 (초 단위)

에러 코드 안내

{
    "error": "invalid_request",
    "error_description": "Invalid request"
}

에러 코드	설명
invalid_request	필수 파라미터 누락, 지원되지 않는 값 사용, 파라미터 중복, 다중 인증 방식 사용 등 잘못된 요청 형식일 경우 발생합니다.
invalid_client	클라이언트 인증 실패 (존재하지 않는 클라이언트, 인증 정보 누락, 지원되지 않는 인증 방식 등). 필요 시 HTTP 401 상태 코드가 반환될 수 있습니다.
unsupported_grant_type	서버에서 지원하지 않는 인증 방식(grant type)을 요청한 경우 발생합니다.
too_many_request	허용된 요청 횟수를 초과한 경우 발생합니다.