🚪

Chez API

Service du soir : 7 étapes, 1 serveur, beaucoup de JSON.

Vous êtes le nouveau serveur du restaurant. Réussissez chaque mission pour débloquer la salle suivante et gagner des pourboires 🪙. À la fin, l'addition révèle votre grade.

🪙 0
Ouvert 24h/24. Sauf erreur 500.

Chez API

Le restaurant où l'on apprend comment les applications se parlent. Au menu : services web, SOAP, REST, Django REST Framework, GraphQL, verbes HTTP et codes d'état. Servi chaud, en JSON.

Entrer dans le restaurant
Plat du jour :
spaghetti au JSON
sauce accolades
200 OKVotre premier plat est servi.
L'apéritif

C'est quoi, un service web ?

Un service web est un programme qu'une application peut appeler à travers le réseau, en général avec HTTP, pour obtenir des données ou déclencher une action. Peu importe le langage de chacun : une app mobile en Kotlin peut très bien discuter avec un serveur en Python. Au restaurant, c'est exactement le rôle du serveur.

Cuisine
BDDle frigo
  1. Le client commandeLe navigateur ou l'app envoie une requête.
  2. Le serveur transmetL'API reçoit la commande et l'apporte en cuisine.
  3. La cuisine prépareLe serveur applicatif traite et va chercher dans la base de données.
  4. Le serveur rapporteLa réponse revient au client, avec un code d'état.

Le client n'entre jamais en cuisine.

Il ne touche pas directement à la base de données. Tout passe par l'API : c'est plus propre, et surtout plus sûr.

Tout le monde parle HTTP.

C'est l'interopérabilité : le client et le serveur peuvent être écrits dans des langages différents, ils se comprennent quand même.

La carte dit ce qu'on peut commander.

La documentation de l'API (le contrat) liste les plats disponibles, comment les demander et ce qu'on reçoit en retour.

L'entrée

SOAP ou REST : deux maisons, deux ambiances

Même commande, un espresso, passée dans deux restaurants. Le premier suit un protocole très strict. Le second suit un style d'architecture beaucoup plus léger. Essayez les deux.

SOAP Palace

Services web étendus : SOAP, WSDL, UDDI

Ici, on ne commande pas : on remplit une enveloppe XML conforme au contrat officiel, le WSDL. L'annuaire UDDI sert à trouver le restaurant. Toujours en POST, toujours en XML, toujours en cravate.

0,0 stemps de service
0 otaille de la commande
  • Enveloppe vérifiée
  • En-tête de sécurité lu (WS-Security)
  • Commande validée contre le WSDL
  • Espresso approuvé par le comité
200conforme au WSDL

REST Café

Un style d'architecture, pas un protocole

On désigne une ressource avec une URL (/api/cafes/espresso), on choisit un verbe HTTP, et on reçoit du JSON. Sans état : chaque commande se suffit à elle-même, le serveur ne se souvient pas de vous.

0,0 stemps de service
0 otaille de la commande
La fiche comparative de la maison
SOAP PalaceREST Café
NatureUn protocole standardisé (W3C)Un style d'architecture (Roy Fielding, 2000)
FormatXML uniquementSurtout JSON, mais aussi XML, texte…
ContratWSDL obligatoire, décrit chaque opérationPas obligatoire (OpenAPI / Swagger en option)
TransportHTTP, SMTP, TCP…HTTP
Façon de commanderDes actions (CommanderCafe), presque toujours en POSTDes ressources (/cafes) et des verbes HTTP
SécuritéWS-Security intégré : signature et chiffrement du messageHTTPS + jetons (JWT, OAuth2)
ErreursUn élément <soap:Fault> dans la réponseLes codes d'état HTTP (404, 500…)
CacheDifficileCache HTTP natif
PoidsLourd et verbeuxLéger et rapide
Clients typiquesBanques, assurances, télécoms, vieux systèmes d'entrepriseWeb, mobile, microservices, API publiques

Choisissez SOAP quand le contrat strict, la sécurité au niveau du message et les transactions comptent plus que la vitesse. Pour presque tout le reste, REST. C'est d'ailleurs au REST Café qu'on dîne pour la suite.

Le plat principal

La carte du REST Café : verbes et codes

En REST, tout est ressource. Ici, ce sont nos plats, à l'adresse /api/plats/. Le verbe dit ce qu'on veut en faire, et le code d'état dit comment ça s'est passé. Choisissez un verbe, imaginez un problème si vous voulez, puis envoyez la commande.

Et si…
Cuisine
Requête
Choisissez un verbe et envoyez la commande.
Réponse
La cuisine attend votre commande.
Codes collectés : 0/8
2xxTout va bien

200 OK, 201 Created (créé), 204 No Content (fait, rien à renvoyer).

3xxLe plat a déménagé

301, 302 : redirection. Le serveur vous indique la nouvelle adresse.

4xxC'est vous qui avez mal commandé

400 commande illisible, 401 pas identifié, 403 pas le droit, 404 introuvable.

5xxC'est la cuisine qui a raté

500 erreur interne, 503 service indisponible. Le client n'y est pour rien.

Le mémo des verbes
VerbeActionSûrIdempotentCode si tout va bien
GETLire une ressourceouioui200 OK
POSTCréer une ressourcenonnon : deux POST, deux plats201 Created
PUTRemplacer la ressource entièrenonoui200 OK
PATCHModifier une partienonpas forcément200 OK
DELETESupprimer la ressourcenonoui204 No Content

Sûr : ne modifie rien sur le serveur. Idempotent : l'envoyer dix fois a le même effet que l'envoyer une seule fois.

Le fromage

DRF ou GraphQL : menu fixe ou bol à composer ?

Deux façons de construire l'API d'un projet Django. Votre besoin est simple : le nom du plat et le nom de son chef. Rien d'autre. Voyons qui vous sert le mieux.

Le menu fixe

Django REST Framework (DRF)

Une URL par ressource. C'est le serveur qui décide de ce qu'il y a dans l'assiette : vous prenez tout. Et le chef est servi à part, sur une autre URL.

GET /api/plats/1/GET /api/chefs/7/
0allers-retours
0champs reçus
–vraiment utiles
Réponses
Le serveur attend.

Over-fetching : on reçoit des champs dont on n'a pas besoin. Under-fetching : une seule requête ne suffit pas, il faut plusieurs allers-retours.

Voir le code Django (DRF)
# serializers.py
class PlatSerializer(serializers.ModelSerializer):
    class Meta:
        model = Plat
        fields = "__all__"

# views.py
class PlatViewSet(viewsets.ModelViewSet):
    queryset = Plat.objects.all()
    serializer_class = PlatSerializer

# urls.py : génère GET, POST, PUT, PATCH, DELETE
router = DefaultRouter()
router.register("plats", PlatViewSet)

Le bol à composer

GraphQL

Une seule adresse : /graphql. C'est vous qui écrivez la liste des ingrédients, et le serveur ne met que ça dans le bol. Le chef ? Il vient dans le même bol.

Requête POST /graphql
0aller-retour
0champs reçus
–vraiment utiles
Réponse
Composez votre bol, puis envoyez.

En GraphQL, on ne choisit pas un verbe HTTP : on écrit une query pour lire ou une mutation pour écrire, presque toujours en POST. Et même en cas d'erreur, la réponse est souvent 200 OK, avec un champ errors. Le serveur sourit, même quand la cuisine brûle.

Voir le code Django (Graphene)
# schema.py
class PlatType(DjangoObjectType):
    class Meta:
        model = Plat

class Query(graphene.ObjectType):
    plat = graphene.Field(PlatType, id=graphene.Int())

    def resolve_plat(root, info, id):
        return Plat.objects.get(pk=id)

schema = graphene.Schema(query=Query)

# Écrire = une mutation
mutation {
  creerPlat(nom: "Couscous", prix: 18) { id nom }
}
Menu fixe ou bol à composer ?
DRF (REST)GraphQL
Points d'entréeUn par ressource : /plats/, /chefs/Un seul : /graphql
Qui choisit les donnéesLe serveurLe client
Verbes HTTPGET, POST, PUT, PATCH, DELETESurtout POST, avec query et mutation
Over / under-fetchingFréquentÉvité
CacheCache HTTP natif, simplePlus complexe (cache côté client)
ErreursCodes HTTP clairs (400, 404…)Souvent 200 + champ errors
Prise en mainRapide, très « Django »Schéma, résolveurs, requêtes N+1 à surveiller
OutilsAPI navigable de DRF, SwaggerGraphiQL, introspection du schéma
Idéal pourCRUD classique, API publiques, projets simplesDonnées imbriquées, plusieurs interfaces (web, mobile, dashboard)
Le dessert

Le conseil du chef : lequel choisir ?

Il n'y a pas de meilleure technologie, seulement une meilleure technologie pour votre projet. Répondez au chef, il vous dira quoi commander.

Pour finir

L'addition, s'il vous plaît

Un service web, c'est un serveur de restaurant.

Il relie le client à la cuisine à travers le réseau, et tout le monde parle HTTP.

SOAP, c'est le grand restaurant à cravate.

XML, contrat WSDL, sécurité intégrée. Lourd, mais rassurant pour les banques.

REST, c'est le bistrot rapide.

Des ressources, des verbes, du JSON, et des codes d'état pour savoir comment ça s'est passé.

DRF ou GraphQL, c'est menu fixe ou bol à composer.

DRF pour la simplicité et le cache, GraphQL quand chaque écran veut des données différentes.

Chez API

Table n°1, atelier services web

17/11/2026, servi par l'API


1 service webcompris
1 SOAP Palace (XML, WSDL)lourd
1 REST Café (JSON)léger
5 verbes HTTP×5
8 codes d'état2xx-5xx
1 menu fixe DRF1 URL/plat
1 bol GraphQLà la carte

Over-fetchingoffert
Pourboire suggéré20/20
TOTAL200 OK

Merci de votre visite !

Aucune donnée n'a été maltraitée
pendant cet atelier.

Réponse
418théière