Anatomie de base d’une requête API

Introduction aux API en Python

Chris Ramakers

Engineering Manager

Qu’est-ce qu’une URL ?

  • URL = Uniform Resource Locator
  • L’adresse structurée d’une ressource d’API
  • Personnalisez l’URL pour cibler des ressources d’API spécifiques
http://350.5th-ave.com/unit/243
Introduction aux API en Python

Disséquer l’URL

Schéma montrant les parties d’une URL : Protocole (http://), Domaine (350.5th-ave.com), Port (:80), Chemin (/unit/243) et Requête (?floor=77).

  • Protocole = moyen de transport
  • Domaine = adresse de l’immeuble
  • Port = porte ou entrée
  • Chemin = bureau précis dans l’immeuble
  • Requête = instructions supplémentaires
Introduction aux API en Python

Ajouter des paramètres de requête avec requests

# Ajouter les paramètres de requête à l’URL
response = requests.get('http://350.5th-ave.com/unit/243?floor=77&elevator=True')
print(response.url)

http://350.5th-ave.com/unit/243?floor=77&elevator=True
  • Utilisez l’argument params pour ajouter des paramètres de requête
# Créer un dictionnaire
query_params = {'floor': 77, 'elevator': True}
# Passer le dictionnaire via l’argument `params`
response = requests.get('http://350.5th-ave.com/unit/243', params=query_params)
print(response.url)

http://350.5th-ave.com/unit/243?floor=77&elevator=True
Introduction aux API en Python

Verbes HTTP

  • Destination : Unité 243 du 350 5th Ave
  • URL : http://350.5th-ave.com/unit/243

Actions

Verbe Action Description
GET Lire Vérifier le contenu de la boîte aux lettres
POST Créer Déposer un nouveau colis dans la boîte
PUT Mettre à jour Remplacer tous les colis par un nouveau
DELETE Supprimer Retirer tous les colis de la boîte
1 Il existe 9 verbes HTTP au total, mais pour les API REST simples, seuls ces 4 sont pertinents
Introduction aux API en Python

Envoyer des données avec POST et PUT

# GET = Récupérer une ressource
response = requests.get('http://350.5th-ave.com/unit/243')

# POST = Créer une ressource
response = requests.post('http://350.5th-ave.com/unit/243', data={"key": "value"})
# PUT = Mettre à jour une ressource existante
response = requests.put('http://350.5th-ave.com/unit/243', data={"key": "value"})

# DELETE = Supprimer une ressource
response = requests.delete('http://350.5th-ave.com/unit/243')
  • Chaque verbe a sa méthode dans le package requests
  • Utilisez l’argument data pour envoyer des données avec POST ou PUT.
Introduction aux API en Python

Passons à la pratique !

Introduction aux API en Python

Preparing Video For Download...