NEXORA API 확인

서버 동작을 확인하는 임시 페이지입니다. 운영 배포 전에 제거하세요.

보관 중인 토큰

로그인, 교환, 재발급에 성공하면 자동으로 채워집니다. 직접 붙여 넣어도 됩니다. 새로고침하면 사라집니다.

웹 Refresh Token은 HttpOnly 쿠키 NEXORA_RT라서 페이지에서 볼 수 없고, 브라우저가 알아서 보냅니다.

전체 흐름 자동 점검

가입부터 토큰 교환, 회전, 이미지, 로그아웃까지 순서대로 호출해 기대한 응답과 비교합니다.

실행할 때마다 현재 연결된 DB에 check-…@nexora.test 계정이 하나씩 남습니다. 탈퇴 API가 없어 자동으로 지우지 못합니다. 또한 이 브라우저의 NEXORA_RT 쿠키를 덮어쓰고 지우므로, 점검 후에는 웹 재발급을 쓰기 전에 다시 로그인하세요.

인증 API

기본 경로 /api/v1. 항목을 펼치면 설명과 호출 폼이 나옵니다.

사용자 API

모두 Access Token이 필요하며, 대상은 항상 토큰의 사용자 본인입니다.

공통 규칙

토큰 전달 방식

	웹 프론트엔드 (WEB)	게임 클라이언트 (GAME)
Access Token	응답 본문	응답 본문
Refresh Token	HttpOnly 쿠키 `NEXORA_RT`	응답 본문 `refreshToken`
재발급	본문 없이 `POST /auth/refresh`	`POST /auth/refresh` + 본문 `refreshToken`

오류 응답 형식 (모든 오류 공통)

{
  "success": false,
  "code": "VALIDATION_FAILED",
  "message": "입력값 검증에 실패했습니다.",
  "errors": [
    { "field": "email", "code": "INVALID_EMAIL", "message": "올바른 이메일 형식이 아닙니다." }
  ]
}

클라이언트는 message가 아니라 code로 분기합니다. errors는 입력 칸별 오류가 있을 때만 포함됩니다.

사용자 응답 객체 user

{
  "uid": "aB3dE5gH7jK9mN1p",
  "email": "user@example.com",
  "nickname": "넥소라",
  "profileImage": {
    "url": "/api/v1/users/me/profile-image",
    "contentType": "image/png",
    "fileSize": 245120,
    "updatedAt": "2026-11-09T04:12:30.123456Z",
    "defaultImage": false
  },
  "createdAt": "2026-11-09T04:10:00.000000Z"
}

오류를 받았을 때 클라이언트 처리

code	웹 프론트엔드	게임 클라이언트

오류 코드

최상위 code

상태	code	의미

필드 errors[].code

code	의미