인증
모든 API 호출 전, apiKey를 사용하여 Access Token을 발급받아야 합니다.
토큰 발급
GET/api/v1/partner/auth/token
파트너 API Key를 사용하여 일회성 Access Token을 발급받습니다.
요청 파라미터
Header Parameters
apiKey
필수
파트너사 고유 API Key입니다.
요청
curl -X GET https://link.eximbay.com/api/v1/partner/auth/token \
-H "apiKey: TEST_API_KEY_1234"
응답 파라미터
token string
필수
Access Token (JWT)입니다.
expiredAt string (ISO 8601)
필수
토큰 만료 일시입니다.
응답
{
"code": "CMN_0000",
"message": "성공",
"data": {
"token": "eyJhbGciOi...",
"expiredAt": "2026-02-04T12:00:00"
}
}
토큰 사용
발급받은 Access Token은 모든 API 요청 시 Authorization 헤더에 Bearer 토큰 형식으로 포함해야 합니다.
토큰은 발급 후 24시간 동안 유효합니다.
만료된 토큰 사용 시 AUTH_3001 에러가 반환됩니다.
토큰 만료 전 새로운 토큰을 발급받아 사용하세요.
요청 파라미터
Header Parameters
Authorization
필수
Bearer {access_token} 형식입니다.
요청
curl -X GET https://link.eximbay.com/api/v1/partner/merchants/{merchantId}/templates \
-H "Authorization: Bearer eyJhbGciOi..."
응답 파라미터 (Error - 토큰 만료)
Error Response (토큰 만료)
{
"code": "AUTH_3001",
"message": "유효하지 않은 토큰입니다"
}