Wprowadzenie do obsługi API

API (interfejsy programowania aplikacji) umożliwiają komunikację między aplikacjami. Biblioteka Pythona requests ułatwia korzystanie z API poprzez wysyłanie żądań HTTP i obsługę odpowiedzi.

W tej lekcji nauczą się Państwo używać biblioteki requests do wysyłania żądań do API i przetwarzania odpowiedzi.

Instalowanie requests

Aby zainstalować bibliotekę requests, użyj następującego polecenia w terminalu:

pip install requests

Po instalacji można zaimportować ją w skryptach Pythona:

# Importing requests
import requests

print("Requests library imported successfully")

Wysyłanie żądania GET

Metoda GET służy do pobierania danych z API. Użyj funkcji requests.get(), aby wysłać żądanie GET:

# Sending a GET request
import requests

response = requests.get("https://jsonplaceholder.typicode.com/posts/1")
print(response.json())  # Outputs the JSON response

Wysyłanie żądania POST

Metoda POST służy do wysyłania danych do API. Proszę użyć funkcji requests.post():

# Sending a POST request
import requests

payload = {"title": "foo", "body": "bar", "userId": 1}
response = requests.post("https://jsonplaceholder.typicode.com/posts", json=payload)
print(response.json())  # Outputs the response

Obsługa odpowiedzi

Biblioteka requests udostępnia kilka atrybutów do obsługi odpowiedzi, takich jak:

• response.status_code: kod statusu HTTP.
• response.json(): dane odpowiedzi w formacie JSON.
• response.text: surowa treść odpowiedzi.

# Handling responses
response = requests.get("https://jsonplaceholder.typicode.com/posts/1")
if response.status_code == 200:
    print("Success:", response.json())
else:
    print("Failed with status code:", response.status_code)

Dodawanie parametrów zapytania

Parametry zapytania można przekazywać do API za pomocą argumentu params w żądaniu GET:

# Adding query parameters
params = {"userId": 1}
response = requests.get("https://jsonplaceholder.typicode.com/posts", params=params)
print(response.json())

Dodawanie nagłówków

Nagłówki umożliwiają wysyłanie wraz z żądaniami dodatkowych informacji, takich jak klucze API lub typy treści:

# Adding headers
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get("https://jsonplaceholder.typicode.com/posts", headers=headers)
print(response.status_code)

Obsługa błędów

Biblioteka requests udostępnia wbudowaną obsługę wyjątków związanych z siecią:

# Handling errors
try:
    response = requests.get("https://jsonplaceholder.typicode.com/invalid")
    response.raise_for_status()
except requests.exceptions.HTTPError as err:
    print("HTTP error occurred:", err)
except requests.exceptions.RequestException as err:
    print("Request error occurred:", err)

Typowe błędy związane z requests

Oto kilka błędów, których należy unikać:

• Nieobsługiwanie błędów HTTP za pomocą response.raise_for_status().
• Umieszczanie poufnych informacji, takich jak klucze API, bezpośrednio w skrypcie.
• Zapominanie o określeniu właściwej metody HTTP (np. GET, POST).

Czego się nauczyliśmy?

W tej lekcji nauczyli się Państwo:

• Jak zainstalować i zaimportować bibliotekę requests.
• Jak wysyłać do API żądania GET i POST.
• Jak obsługiwać odpowiedzi, dodawać parametry zapytania i nagłówki oraz obsługiwać błędy.

Świetna robota! Przejdźmy do następnego tematu.