Obiective

1. Introducere în API-uri și utilizarea lor în aplicații
2. Înțelegerea conceptelor de bază ale comunicării HTTP
3. Învățarea bibliotecii requests pentru lucrul cu API-uri în Python
4. Exemple practice de utilizare a bibliotecii requests pentru a interacționa cu API-uri

1. Introducere în API-uri și utilizarea lor în aplicații

Un API (Application Programming Interface) este un set de reguli și specificații care permit comunicarea între două aplicații. De obicei, un API furnizează un mod simplu și standardizat de a accesa date sau de a interacționa cu un serviciu sau o aplicație. În acest context, ne vom concentra pe API-urile web, care folosesc protocolul HTTP pentru a comunica între client și server.

2. Concepte de bază ale comunicării HTTP

Comunicarea HTTP se bazează pe cereri și răspunsuri între client și server. O cerere HTTP conține o metodă (cum ar fi GET, POST, PUT, DELETE etc.), un URL și, opțional, un set de antete și un corp. Un răspuns HTTP conține un cod de stare, un set de antete și un corp.

Cele mai comune metode HTTP sunt:

• GET: solicită date de la un URL specificat
• POST: trimite date către un URL specificat pentru a crea o resursă nouă
• PUT: trimite date către un URL specificat pentru a actualiza o resursă existentă
• DELETE: șterge resursa de la un URL specificat

3. Învățarea bibliotecii requests pentru lucrul cu API-uri în Python

Biblioteca requests este o bibliotecă populară de Python care simplifică lucrul cu API-uri web. Pentru a utiliza requests, trebuie să o instalați folosind pip:

pip install requests

După instalare, puteți importa biblioteca și începe să trimiteți cereri HTTP. De exemplu, pentru a trimite o cerere GET către un API, utilizați funcția requests.get():

import requests

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

4. Exemple practice de utilizare a bibliotecii requests pentru a interacționa cu API-uri

1. Trimiterea unei cereri GET și afișarea răspunsului:

import requests

url = 'https://jsonplaceholder.typicode.com/todos/1'
response = requests.get(url)

if response.status_code == 200:
    print(response.json())
else:
    print(f'Eroare {response.status_code}: {response.text}')

2. Trimiterea unei cereri POST pentru a crea o nouă resursă:

import requests
import json

url = 'https://jsonplaceholder.typicode.com/posts'
headers = {'Content-Type': 'application/json'}
data = {
    'title': 'Exemplu de titlu',
    'body': 'Acesta este un exemplu de conținut',
    'userId': 1
}

response = requests.post(url, headers=headers, data=json.dumps(data))

if response.status_code == 201:
    print('Resursa a fost creată cu succes:')
    print(response.json())
else:
    print(f'Eroare {response.status_code}: {response.text}')

3. Trimiterea unei cereri PUT pentru a actualiza o resursă existentă:

import requests
import json

url = 'https://jsonplaceholder.typicode.com/posts/1'
headers = {'Content-Type': 'application/json'}
data = {
    'title': 'Titlu actualizat',
    'body': 'Conținut actualizat'
}

response = requests.put(url, headers=headers, data=json.dumps(data))

if response.status_code == 200:
    print('Resursa a fost actualizată cu succes:')
    print(response.json())
else:
    print(f'Eroare {response.status_code}: {response.text}')

4. Trimiterea unei cereri DELETE pentru a șterge o resursă:

import requests

url = 'https://jsonplaceholder.typicode.com/posts/1'

response = requests.delete(url)

if response.status_code == 200:
    print('Resursa a fost ștearsă cu succes.')
else:
    print(f'Eroare {response.status_code}: {response.text}')

În această lecție, am discutat despre conceptele de bază ale API-urilor web și comunicării HTTP, am învățat să folosim biblioteca requests pentru a trimite cereri HTTP și am prezentat exemple practice pentru a interacționa cu API-uri în Python. Aceste cunoștințe vă vor permite să integrați și să utilizați API-uri web în aplicațiile dvs. Python.