API 레퍼런스

HTTPC는 28개 요청 옵션 함수, 5개 설정 프리셋, 7개 내장 미들웨어와 완전한 다운로드 지원을 제공합니다.

핵심 아키텍처

HTTPC는 2계층 설계를 채택합니다. Layer 1의 메서드 API는 얇은 래퍼이며, 실제로 요청을 처리하는 엔진은 Layer 2의 Handler 파이프라인입니다.

HTTPC 2계층 아키텍처
├── Layer 1  메서드 API(얇은 래퍼)
│     패키지 함수 httpc.Get/Post/... + Client 메서드 + 요청 옵션 → Result
│
└── Layer 2  Handler 파이프라인(요청 처리 엔진)
      MiddlewareFunc(Handler) 양파 체인
      → clientImpl.middlewareChain 조립
      → 실행(각 요청 = Handler 체인 조립 및 실행)

모듈 탐색

핵심

모듈	설명
패키지 함수와 클라이언트 메서드	Get/Post/Put/Patch/Delete 등 패키지 함수, 클라이언트 메서드와 보조 함수
설정	Config 구조체, 5가지 프리셋 설정, 검증 함수와 Cookie 보안
인터페이스	Client, Doer, DomainClienter, RetryPolicy 등 핵심 인터페이스
Result	Result, RequestInfo, ResponseInfo, RequestMeta 타입과 모든 메서드
핸들러 파이프라인	Handler 파이프라인, MiddlewareFunc 양파 체인, Chain 결합기와 Mutator 계약

요청과 응답

모듈	설명
요청 옵션	28개 WithXxx 요청 옵션 함수(요청 헤더, 본문, 인증, Cookie, 콜백 등)
미들웨어	Chain 조합, 7개 내장 미들웨어 팩토리와 감사 이벤트 타입
오류 타입	ClientError, 12가지 ErrorType 열거와 12개 오류 변수

고급 기능

모듈	설명
도메인 클라이언트	DomainClient 생성, HTTP 메서드, 다운로드 메서드와 URL 조합 규칙
세션 관리	SessionManager의 Cookie/요청 헤더 관리와 보안 검증
파일 다운로드	다운로드 함수, DownloadConfig, 이어받기와 보안 보호
상수와 타입	BodyKind 열거, FormData/FileData와 감사 컨텍스트 키

빠른 참조

클라이언트 생성

client, err := httpc.NewDefault()             // 기본 설정
client, err := httpc.New(httpc.SecureConfig()) // 보안 프리셋
client, err := httpc.New(customConfig)         // 사용자 정의 설정

요청 전송

// 패키지 함수
result, err := httpc.Get(url, options...)

// 클라이언트 메서드
result, err := client.Get(url, options...)

// 컨텍스트 포함
result, err := client.Request(ctx, "GET", url, options...)

응답 처리

result.StatusCode()           // 상태 코드
result.Body()                 // 응답 본문(문자열)
result.RawBody()              // 응답 본문(바이트)
result.Unmarshal(&data)       // JSON 파싱
result.IsSuccess()            // 2xx 여부
result.Meta.Duration          // 요청 소요 시간
result.Meta.Attempts          // 재시도 횟수