메인 콘텐츠로 건너뛰기
SonamuContext는 API 요청 처리 중에 필요한 정보들을 담고 있는 객체입니다.

Context 개요

Request 정보

HTTP 요청 데이터 헤더, 바디, 쿼리

Reply 객체

HTTP 응답 제어 상태 코드, 헤더

User 정보

인증된 사용자 ID, 권한, 역할

확장 가능

커스텀 필드 추가 프로젝트별 데이터

SonamuContext 구조

기본 구조

Sonamu는 내부적으로 Fastify를 사용하므로, request와 reply는 Fastify의 객체입니다.

Context 구성 요소

1. Request

HTTP 요청과 관련된 모든 정보를 담고 있습니다.
주요 속성:
  • headers: HTTP 헤더 (객체)
  • query: URL 쿼리 파라미터 (객체)
  • body: 요청 바디 (POST/PUT 등)
  • params: URL 경로 파라미터
  • ip: 클라이언트 IP 주소
  • hostname: 호스트명
  • url: 요청 URL
  • method: HTTP 메서드

2. Reply

HTTP 응답을 제어할 수 있습니다.
주요 메서드:
  • status(code): 상태 코드 설정
  • header(name, value): 응답 헤더 설정
  • cookie(name, value, options): 쿠키 설정
  • redirect(url): 리다이렉트
  • send(data): 응답 전송 (일반적으로 자동)

3. User

인증된 사용자 정보를 담고 있습니다.
context.user는 인증 미들웨어에 의해 설정됩니다. 인증이 필요한 API에서는 항상 context.user의 존재 여부를 확인해야 합니다.

실전 사용 예제

인증 확인

권한 확인

로깅

커스텀 헤더

쿠키 처리

IP 기반 제한

Rate Limiting 정보

Context 사용 패턴

주의사항

Context 사용 시 주의사항: 1. API 메서드 내에서만 접근 가능 2. context.user는 인증 후에만 존재 3. 비동기 작업 중에도 동일한 Context 유지 4. Context 수정은 신중하게 5. 응답 헤더는 데이터 전송 전에 설정

흔한 실수

다음 단계

Context 가져오기

Sonamu.getContext() 사용법

커스텀 Context

Context 확장하기

@api 데코레이터

API 기본 사용법

에러 처리

API 에러 핸들링