---
title: "OAuth SSO 로그인"
method: POST
path: "/api/v1/oauth/login"
tags: ["인증"]
---

# OAuth SSO 로그인

`POST /api/v1/oauth/login`

Client Credentials로 SSO 로그인을 합니다.

## Request body

- LoginRequest
  - `accessKey` string — 발급받은 accessKey
  - `verifyToken` string — 파트너사 인증 token

## Response `200`

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

- ApiResponseOAuthResponse
  - `result` 'SUCCESS' | 'FAIL', required — 응답 결과 타입
  - `data` OAuthResponse
    - `user` OAuthUserResponse, required
      - `id` string, required — 사용자 ID
      - `origin` string, required — 파트너사 영어 이름
      - `uid` string, required — 파트너사 사용자 ID
      - `name` string — 사용자 이름
      - `imageUrl` string — 프로필 이미지 URL
      - `email` string, required — 이메일
      - `role` 'USER' | 'DESIGNER' | 'MANAGER' | 'ADMIN', required — 역할 (USER: 일반 사용자, DESIGNER: 디자이너, MANAGER: 매니저, ADMIN: 관리자)
      - `categoryId` string — 카테고리 ID
      - `createdAt` string, date-time, required — 생성일시
      - `updatedAt` string, date-time, required — 수정일시
    - `token` OAuthTokenResponse, required
      - `access` string, required — 액세스 토큰
      - `refresh` string, required — 리프레시 토큰
  - `error` ErrorMessage
    - `errorCode` 'INTERNAL_ERROR' | 'BAD_REQUEST' | 'NOT_FOUND' | 'CONFLICT' | 'FORBIDDEN' — 에러 코드
    - `message` string — 에러 메시지

---

[API](https://skmtc.dev/archisketch/apis/open-api.md) · [All operations](https://skmtc.dev/archisketch/apis/open-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/archisketch/open-api/revisions/f6b0eda1a99d/schema)