API Flashcards
Que veut dire API ?
Application Programming Interface
Que veut dire REST ?
REpresentational State Transfer
(REST est un ensemble de normes et style d’architecture pour les APIs)
Quelles sont les contraintes REST ?
Client/Server separation
Stateless (sans état, chaque requête doit être traitée comme une nouvelle requête : le serveur ne sauvegarde aucune des requêtes ou réponses précédentes)
Cacheable (les données doivent pouvoir être sauvegardables par le client)
Uniform interface : une ressource dans le système doit avoir une seule URI, quelque soit le client qui appelle cette URI, le résultat doit être le même (les guidelines de naming et format doivent être respectées)
Layered system (quand on se connecte à l’API, on ne sait pas si elle-même se connecte à d’autres API ou non)
Code-on-demand architecture : peut retourner du code exécutable plutôt que du JSON (optionnel)
Que veut dire SOAP ?
Simple Object Access Protocol
Sur quel protocole se basent les API RESTful ?
HTTP
Dans quoi sont représentées les données REST ?
Dans des ressources
(une ressource peut être tout type d’objet nominal)
Dans quoi sont regroupées les ressources ?
Dans des collections
Que veut dire URI ?
Uniform Resource Identifier
(c’est le path unique pour récupérer ma ressource)
Quelle est la différence entre URI et URL ?
L’URI permet d’identifier une ressource tandis que l’URL permet de la localiser.
Qu’est-ce qu’un endpoint ?
Un endpoint est une URL/URI qui fait partie d’une API.
Qu’est-ce que l’URL d’une requête API ?
L’URL de la requête est l’endpoint complet utilisé pour la requête. Il associe le nom de domaine + le path de la ressource.
Quelle est la structure d’une requête API ?
URI + Méthode (verbe) HTTP + Header (données d’authentification par exemple) + Body (facultatif)
Quels sont les 5 verbes HTTP les plus fréquents ?
GET, POST, PUT, PATCH, DELETE
Quelle est la différence la différence entre PUT et PATCH ?
PUT remplace une donnée existante ou la créé si elle n’existe pas
PATCH modifie partiellement une donnée existante
