Python HTTP 통신 개념 정리

1️⃣ HTTP 기초

HTTP는 클라이언트와 서버 간의 통신을 위한 프로토콜이다.

import requests
import json

# 기본 GET 요청
response = requests.get('https://api.example.com/data')
print(f"상태 코드: {response.status_code}")  # 상태 코드
print(f"응답 헤더: {response.headers}")     # 응답 헤더
print(f"응답 내용: {response.text}")        # 응답 내용
print(f"JSON 응답: {response.json()}")      # JSON 응답 파싱

# 응답 상태 확인
if response.status_code == 200:
    print("요청 성공!")
elif response.status_code == 404:
    print("리소스를 찾을 수 없습니다")
else:
    print(f"오류 발생: {response.status_code}")

# 기본 POST 요청
data = {'username': 'user1', 'email': '[email protected]'}
response = requests.post('https://api.example.com/users', json=data)

# multipart/form-data 요청 (파일 업로드)
files = {'file': open('document.pdf', 'rb')}
form_data = {'description': '중요 문서'}
response = requests.post(
    'https://api.example.com/upload', 
    files=files, 
    data=form_data
)

# PUT 요청 (리소스 수정)
update_data = {'username': 'updated_user', 'email': '[email protected]'}
response = requests.put('https://api.example.com/users/123', json=update_data)

# DELETE 요청 (리소스 삭제)
response = requests.delete('https://api.example.com/users/123')

# 타임아웃 설정
try:
    response = requests.get('https://api.example.com/data', timeout=5)  # 5초 타임아웃
except requests.exceptions.Timeout:
    print("요청 시간이 초과되었습니다")

✅ 특징:

간단한 요청/응답
JSON 처리
상태 코드 확인
다양한 HTTP 메서드 지원
타임아웃 설정
파일 업로드
상태 코드 처리

HTTP 메서드:

HTTP 통신에서 사용되는 주요 메서드와 용도이다.

메서드	목적	특징	Python 예제
GET	데이터 조회	데이터를 URL에 포함, 캐싱 가능	`requests.get(url)`
POST	데이터 생성	데이터를 본문에 포함, 캐싱 불가	`requests.post(url, json=data)`
PUT	데이터 수정	리소스 전체 대체, 멱등성	`requests.put(url, json=data)`
PATCH	데이터 부분 수정	리소스 일부 수정	`requests.patch(url, json=data)`
DELETE	데이터 삭제	리소스 제거	`requests.delete(url)`
HEAD	헤더만 조회	본문 없이 헤더만 반환	`requests.head(url)`
OPTIONS	지원 옵션 확인	서버 지원 옵션 확인	`requests.options(url)`

2️⃣ 요청 헤더와 매개변수

HTTP 요청에 헤더와 매개변수를 추가하여 서버와의 통신을 커스터마이징하는 방법이다.

import requests
from requests.auth import HTTPBasicAuth, HTTPDigestAuth

# 헤더 추가
headers = {
    'User-Agent': 'Python/3.9 Requests/2.26.0',
    'Authorization': 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...',
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'X-Request-ID': '123e4567-e89b-12d3-a456-426614174000',
    'Cache-Control': 'no-cache'
}

# URL 매개변수 (쿼리 파라미터)
params = {
    'page': 1,
    'limit': 10,
    'sort': 'created_at',
    'order': 'desc',
    'filter': 'active'
}

# 기본 요청
response = requests.get(
    'https://api.example.com/users',
    headers=headers,
    params=params
)

print(f"최종 URL: {response.url}")  # 쿼리 파라미터가 포함된 URL 출력

# 기본 인증 (Basic Authentication)
response = requests.get(
    'https://api.example.com/protected',
    auth=HTTPBasicAuth('username', 'password')
)

# 다이제스트 인증 (Digest Authentication)
response = requests.get(
    'https://api.example.com/protected',
    auth=HTTPDigestAuth('username', 'password')
)

# API 키 인증
api_key = '1234567890abcdef'
# 쿼리 파라미터로 API 키 전달
response = requests.get(
    'https://api.example.com/data',
    params={'api_key': api_key}
)

# 헤더로 API 키 전달
response = requests.get(
    'https://api.example.com/data',
    headers={'X-API-Key': api_key}
)

# OAuth 2.0 인증
token = 'access_token_here'
response = requests.get(
    'https://api.example.com/me',
    headers={'Authorization': f'Bearer {token}'}
)

# 쿠키 설정
cookies = {'session_id': '12345', 'user_id': '42'}
response = requests.get(
    'https://api.example.com/dashboard',
    cookies=cookies
)

# 응답 쿠키 확인
print(response.cookies)
for cookie in response.cookies:
    print(f"{cookie.name}: {cookie.value}")

✅ 특징:

헤더 커스터마이징
매개변수 전달
인증 처리
쿠키 관리
API 키 인증
OAuth 지원
커스텀 헤더

일반적인 HTTP 헤더:

HTTP 통신에서 자주 사용되는 요청 및 응답 헤더이다.

헤더	용도	예시
Content-Type	데이터 형식 지정	`application/json`, `multipart/form-data`
Authorization	인증 정보 전달	`Bearer token123`, `Basic base64encoded`
User-Agent	클라이언트 식별	`Python/3.9 Requests/2.26.0`
Accept	응답 형식 요청	`application/json`, `text/html`
Cache-Control	캐싱 동작 제어	`no-cache`, `max-age=3600`
Cookie	쿠키 전송	`session_id=abc123`
X-Request-ID	요청 추적	`123e4567-e89b-12d3-a456-426614174000`

3️⃣ 세션 관리

세션을 사용하여 여러 요청 간에 상태를 유지하고 효율적으로 HTTP 통신을 관리하는 방법이다.

import requests
import time

# 세션 생성
session = requests.Session()

# 세션에 기본 헤더 설정
session.headers.update({
    'User-Agent': 'Python/3.9 SessionClient/1.0',
    'Authorization': 'Bearer token123',
    'Accept': 'application/json'
})

# 세션에 기본 쿠키 설정
session.cookies.update({'user_preference': 'dark_mode'})

# 세션을 통한 요청 - 모든 요청에 헤더와 쿠키가 자동으로 포함됨
response = session.get('https://api.example.com/profile')
print(f"프로필 응답: {response.status_code}")

# 세션에 추가 매개변수 설정
response = session.get(
    'https://api.example.com/articles',
    params={'category': 'technology', 'page': 1}
)
print(f"기사 응답: {response.status_code}")

# 세션을 통한 POST 요청
response = session.post(
    'https://api.example.com/comments',
    json={'article_id': 42, 'text': '좋은 기사입니다!'}
)
print(f"댓글 응답: {response.status_code}")

# 세션에 인증 설정 (모든 요청에 적용)
session.auth = ('username', 'password')
response = session.get('https://api.example.com/secure')

# 세션에 요청 훅 추가
def logging_hook(response, *args, **kwargs):
    print(f"요청 URL: {response.url}")
    print(f"상태 코드: {response.status_code}")
    print(f"응답 시간: {response.elapsed.total_seconds()}초")
    return response

session.hooks['response'] = [logging_hook]

# 세션에 타임아웃 설정
session.request('GET', 'https://api.example.com/data', timeout=(3.05, 27))  # (연결 타임아웃, 읽기 타임아웃)

# 컨텍스트 매니저로 세션 사용 (자동으로 리소스 정리)
with requests.Session() as session:
    session.headers.update({'Authorization': 'Bearer session_token'})
    response = session.get('https://api.example.com/data')
    print(f"응답: {response.json()}")
    
    # 세션 내에서 여러 요청 수행
    for page in range(1, 4):
        response = session.get(
            'https://api.example.com/articles',
            params={'page': page}
        )
        articles = response.json().get('articles', [])
        print(f"페이지 {page}: {len(articles)} 기사")

# 세션 상태 확인 및 리소스 정리
print(f"세션 쿠키: {session.cookies}")
print(f"세션 헤더: {session.headers}")
session.close()  # 세션 리소스 명시적 정리

✅ 특징:

세션 재사용
헤더 유지
쿠키 관리
인증 정보 보존
리소스 효율성
네트워크 최적화
요청 훅 지원

세션 사용의 이점:

세션을 사용하여 HTTP 요청을 관리할 때의 장점이다.

연결 재사용: TCP 연결을 재사용하여 네트워크 효율성 향상
쿠키 자동 관리: 서버가 설정한 쿠키를 자동으로 저장하고 후속 요청에 포함
일관된 헤더: 모든 요청에 동일한 기본 헤더 적용 가능
인증 상태 유지: 로그인 후 인증 상태를 유지하며 요청 가능
TCP 연결 풀링: HTTP Keep-Alive를 통한 연결 풀링으로 성능 향상
자원 관리 간소화: 컨텍스트 매니저를 통한 자동 리소스 정리 가능

4️⃣ 에러 처리와 재시도

import time
from requests.exceptions import RequestException

def make_request_with_retry(url, max_retries=3, delay=1):
    for attempt in range(max_retries):
        try:
            response = requests.get(url)
            response.raise_for_status()
            return response
        except RequestException as e:
            if attempt == max_retries - 1:
                raise e
            time.sleep(delay * (attempt + 1))
    return None

✅ 특징:

예외 처리
재시도 로직
지연 시간 설정

5️⃣ 비동기 HTTP 요청

import aiohttp
import asyncio

async def fetch_url(session, url):
    async with session.get(url) as response:
        return await response.text()

async def main():
    urls = [
        'https://api.example.com/1',
        'https://api.example.com/2',
        'https://api.example.com/3'
    ]
    
    async with aiohttp.ClientSession() as session:
        tasks = [fetch_url(session, url) for url in urls]
        results = await asyncio.gather(*tasks)
        return results

✅ 특징:

비동기 처리
동시 요청
성능 최적화

6️⃣ 실용적인 예제

class APIClient:
    def __init__(self, base_url, api_key=None):
        self.base_url = base_url.rstrip('/')
        self.session = requests.Session()
        
        if api_key:
            self.session.headers.update({
                'Authorization': f'Bearer {api_key}'
            })
    
    def _make_request(self, method, endpoint, **kwargs):
        url = f"{self.base_url}/{endpoint.lstrip('/')}"
        response = self.session.request(method, url, **kwargs)
        response.raise_for_status()
        return response.json()
    
    def get(self, endpoint, params=None):
        return self._make_request('GET', endpoint, params=params)

✅ 특징:

클래스 기반 구현
메서드 추상화
재사용성

주요 팁

✅ 모범 사례:

타임아웃 설정
적절한 에러 처리
세션 재사용
비동기 요청 활용
헤더 관리
인증 처리
재시도 로직 구현
프록시 사용 고려

KR_HTTP - somaz94/python-study GitHub Wiki

Python HTTP 통신 개념 정리

1️⃣ HTTP 기초

HTTP 메서드:

2️⃣ 요청 헤더와 매개변수

일반적인 HTTP 헤더:

3️⃣ 세션 관리

세션 사용의 이점:

4️⃣ 에러 처리와 재시도

5️⃣ 비동기 HTTP 요청

6️⃣ 실용적인 예제

주요 팁

⚠️ GitHub.com Fallback ⚠️

KR_HTTP - somaz94/python-study GitHub Wiki

Python HTTP 통신 개념 정리

1️⃣ HTTP 기초

HTTP 메서드:

2️⃣ 요청 헤더와 매개변수

일반적인 HTTP 헤더:

3️⃣ 세션 관리

세션 사용의 이점:

4️⃣ 에러 처리와 재시도

5️⃣ 비동기 HTTP 요청

6️⃣ 실용적인 예제

주요 팁

⚠️ **GitHub.com Fallback** ⚠️

⚠️ GitHub.com Fallback ⚠️