카테고리 없음

Requests 라이브러리 완벽 가이드

bookareader 2025. 3. 13. 21:00
반응형
Requests 라이브러리 완벽 가이드

Python의 Requests 라이브러리는 웹 상의 데이터를 쉽게 가져오고, 전송할 수 있는 강력한 도구입니다. HTTP 요청을 간편하게 수행할 수 있도록 도와주며, 다양한 기능과 옵션을 제공합니다. 본 글에서는 Requests 라이브러리의 기본 사용법, 실용적인 팁, 그리고 실제 사례를 통해 이 라이브러리를 어떻게 활용할 수 있는지 알아보겠습니다.

Requests 라이브러리 소개

Requests는 Python에서 HTTP 요청을 보내기 위한 가장 인기 있는 라이브러리 중 하나입니다. 이 라이브러리는 웹 API와의 상호작용, 데이터 크롤링, 웹 페이지의 HTML 소스 가져오기 등 다양한 용도로 사용됩니다. 설치는 pip install requests 명령어로 간단히 진행할 수 있습니다.

실용적인 팁 5가지

1. GET 요청의 기본 사용법

GET 요청은 서버로부터 정보를 요청하는 가장 기본적인 방법입니다. Requests 라이브러리에서 GET 요청을 보내려면 다음과 같이 작성할 수 있습니다:

import requests
response = requests.get('https://api.example.com/data')
print(response.text)

이 코드는 지정한 URL로 GET 요청을 보내고, 응답으로 받은 데이터를 출력합니다. response.text 속성을 사용하여 서버의 응답을 문자열 형태로 가져올 수 있습니다.

2. POST 요청으로 데이터 전송하기

POST 요청은 서버에 데이터를 전송하는 데 사용됩니다. 아래는 POST 요청을 사용하는 예제입니다:

import requests
data = {'key': 'value'}
response = requests.post('https://api.example.com/submit', data=data)
print(response.status_code)

이 코드는 'key'와 'value' 쌍으로 구성된 데이터를 서버에 전송하고, 응답의 상태 코드를 출력합니다. 이를 통해 데이터 전송이 성공했는지 확인할 수 있습니다.

3. 오류 처리하기

Requests 라이브러리를 사용할 때는 오류 처리가 중요합니다. 서버의 응답 상태 코드를 확인하여 요청이 성공했는지 확인하고, 실패 시 적절한 처리를 해야 합니다:

response = requests.get('https://api.example.com/data')
if response.status_code == 200:
    print('성공:', response.text)
else:
    print('오류 발생:', response.status_code)

위 코드는 상태 코드가 200인 경우에만 성공적으로 데이터를 출력하며, 그렇지 않은 경우 오류 메시지를 출력합니다.

4. 헤더 추가하기

특정 API에서는 요청할 때 헤더를 추가해야 할 경우가 많습니다. 아래의 예제는 사용자 에이전트를 설정하는 방법입니다:

headers = {'User-Agent': 'my-app/0.0.1'}
response = requests.get('https://api.example.com/data', headers=headers)

이 코드는 요청 시 사용자 에이전트 정보를 포함하여 서버에 요청을 보냅니다. API 문서에서 요구하는 헤더 정보를 확인하고 추가하는 것이 중요합니다.

5. JSON 데이터 처리하기

많은 API에서 JSON 형식으로 데이터를 주고받습니다. Requests 라이브러리에서는 JSON 데이터를 쉽게 처리할 수 있습니다:

response = requests.get('https://api.example.com/data')
data = response.json()
print(data)

이 코드는 응답을 JSON 형식으로 변환하여 Python 객체로 다룰 수 있도록 합니다. JSON 데이터는 보통 딕셔너리 형태로 반환됩니다.

실제 사례 3가지

사례 1: 날씨 정보 가져오기

날씨 정보를 제공하는 API를 사용하여 특정 도시의 날씨 데이터를 가져오는 예를 살펴보겠습니다. OpenWeatherMap API를 사용하여 특정 도시의 날씨를 조회할 수 있습니다:

import requests

city = 'Seoul'
api_key = 'YOUR_API_KEY'
url = f'http://api.openweathermap.org/data/2.5/weather?q={city}&appid={api_key}'

response = requests.get(url)
if response.status_code == 200:
    weather_data = response.json()
    print(f"{city}의 날씨: {weather_data['weather'][0]['description']}")
else:
    print('날씨 정보를 가져오는 데 실패했습니다.')

이 코드는 OpenWeatherMap API를 호출하여 서울의 날씨 정보를 가져옵니다. 사용자는 자신의 API 키를 입력해야 하며, 응답에서 날씨 설명을 출력합니다.

사례 2: 웹 페이지 크롤링

Requests를 사용하여 웹 페이지의 HTML 소스를 가져오는 방법도 매우 유용합니다. 아래 코드는 특정 웹 페이지의 내용을 가져오는 예제입니다:

import requests

url = 'https://example.com'
response = requests.get(url)
if response.status_code == 200:
    print('웹 페이지 내용:')
    print(response.text)
else:
    print('페이지를 가져오는 데 실패했습니다.')

이 코드는 지정된 URL의 HTML 소스를 가져와 출력합니다. 웹 크롤링 시 필요한 정보를 추출하여 분석하는 데 유용합니다.

사례 3: 사용자 인증이 필요한 API 접근

일부 API는 인증을 요구합니다. 예를 들어, GitHub API에 접근하기 위해 OAuth 토큰을 사용하는 방법은 다음과 같습니다:

import requests

url = 'https://api.github.com/user/repos'
headers = {'Authorization': 'token YOUR_ACCESS_TOKEN'}
response = requests.get(url, headers=headers)
if response.status_code == 200:
    repos = response.json()
    print('저장소 리스트:')
    for repo in repos:
        print(repo['name'])
else:
    print('저장소 정보를 가져오는 데 실패했습니다.')

이 코드는 GitHub API를 호출하여 사용자의 저장소 목록을 가져옵니다. OAuth 토큰을 사용하여 인증을 수행하며, 응답으로 받은 저장소 이름을 출력합니다.

요약 및 실천 팁


Requests 라이브러리는 Python에서 HTTP 요청을 간편하게 처리할 수 있는 매우 유용한 도구입니다. 본 글에서는 기본 사용법과 실용적인 팁, 그리고 다양한 사례를 통해 Requests 라이브러리를 활용하는 방법에 대해 알아보았습니다. 다음은 요약된 실천 팁입니다:

  • GET 및 POST 요청을 이해하라 - HTTP 요청의 기본적인 개념을 이해하고, 실용적인 예제를 통해 학습하라.
  • 오류 처리를 철저히 하라 - 요청의 성공 여부를 확인하고, 적절한 오류 처리를 통해 안정성을 높여라.
  • 헤더 및 인증 정보 관리하기 - API 문서를 참고하여 필요한 헤더와 인증 정보를 정확히 설정하라.
  • JSON 데이터 핸들링을 익히기 - JSON 형식의 데이터를 적절히 처리하는 방법을 익혀, 다양한 API와의 통신을 원활하게 하라.
  • 웹 크롤링 시 주의사항 - 크롤링 시 웹사이트의 이용 약관을 준수하고, 요청 간 시간 간격을 두어 서버에 부담을 주지 않도록 하라.

이러한 팁들을 바탕으로 Requests 라이브러리를 활용하여 다양한 프로젝트에 적용해 보십시오. 웹 API와의 상호작용, 데이터 수집 등 여러 방면에서 유용할 것입니다.

반응형