Phenquestions
Pourquoi UTILISER L'API REST :
Dans les applications Web traditionnelles, disons un simple serveur Web PHP,
- Vous demandez une page (disons php) depuis le serveur.
- Le serveur trouve le fichier de script (php) correspondant à la page que vous avez demandée et commence à l'exécuter. Le script se connecte à la base de données, recherche les informations requises, place les informations dans la page d'une manière bien formatée (mélange HTML + CSS + JavaScript avec les données) qui semble très attrayant pour le visiteur.
- Ensuite, le serveur le renvoie au visiteur.
Dans ce modèle, tout le traitement est effectué côté serveur. Donc le serveur doit faire plus de travail. Ici, les données ne sont pas séparées de la page, elles sont profondément intégrées à la page.
Si à l'avenir, vous souhaitez créer une application Android ou une application iOS ou une application de bureau de votre site Web, vous devrez faire beaucoup plus de travail. Vous devrez vous connecter à la base de données directement depuis chacune de ces applications, ce qui peut ne pas être très sécurisé. Le temps de développement augmentera et des problèmes de portabilité surviendront.
Disons que vous avez réussi à créer des applications Desktop, Android et iOS de votre site Web. Le nom complet de l'utilisateur est affiché en minuscule dans chacun d'eux. Maintenant, vous souhaitez l'afficher en majuscules. Eh bien, les développeurs doivent modifier séparément les versions Desktop, Android et iOS de votre application pour ce faire. Ce qui prend du temps. Dans le monde réel, les choses ne seront pas aussi simples que celle-ci. Ainsi, une version de l'application (disons la version Desktop) peut avoir un bug sérieux dans le processus de mise à jour. Le réparer plus tard prendrait plus de temps. Pouvez-vous voir comment le temps de développement augmente? Cette solution n'est pas non plus portable.
Dans l'API REST, vous demandez au serveur API ce dont vous avez besoin et il vous envoie uniquement les informations que vous demandez, aucun formatage supplémentaire n'est effectué dans le serveur. Il n'y a pas besoin de traitement inutile dans le serveur. Ainsi, les performances de votre site Web et de vos applications sont naturellement améliorées. En outre, vous pouvez utiliser les mêmes données sur votre site Web, votre application de bureau, vos applications Android et iOS. Les modifications apportées aux serveurs seront reflétées dans les applications qui utilisent l'API. Le temps et le coût de développement de l'application seront également réduits.
Comment fonctionne l'API REST :
Les API REST ont des points de terminaison. Un point de terminaison n'est rien de plus qu'une URL, mais d'une manière bien formatée et significative. Il utilise les requêtes HTTP natives (telles que OBTENIR, PUBLIER, METTRE, EFFACER etc) pour décider quoi faire lorsque vous accédez à chaque point de terminaison. j'en parlerai plus tard.
Le format de sortie de l'API REST est JSON également connu sous le nom de notation d'objet JavaScript.
Un exemple de sortie d'un OBTENIR demande à l'API REST sur /users/id/12 le point de terminaison peut ressembler à ceci :
"identifiant": 12,
"nom": "David Smith",
"âge": 42,
"téléphones": ["124-211-2341", "889-211-4545"],
"pays": "US"
Comme vous pouvez le voir, j'ai fait un OBTENIR demande sur /users/id/12 point de terminaison pour dire à l'API REST de me donner des informations sur l'utilisateur qui a le identifiant 12. J'ai juste les informations que j'ai demandées, rien de plus, rien de moins.
Disons maintenant que vous voulez des informations sur les 10 derniers utilisateurs qui se sont inscrits sur votre site Web. Vous pouvez faire un OBTENIR demande sur /utilisateurs/dernier/10 point final.
Vous pouvez également ajouter de nouvelles données sur votre serveur en utilisant l'API REST. Généralement, le HTTP PUBLIER la requête est utilisée pour demander à l'API REST d'ajouter de nouvelles données au serveur d'API.
Par exemple, vous pouvez faire un PUBLIER demande sur /utilisateurs point de terminaison avec les données du nouvel utilisateur et il sera ajouté à la base de données sur votre serveur API. Vous pouvez également configurer votre API pour renvoyer le statut de la demande.
"statutCode": 400,
"statusText": "Utilisateur ajouté avec succès.",
"Les données":
"identifiant": 13,
"nom": "Marie Smith",
"âge": 35,
"téléphones": ["124-211-2341", "889-211-4545"],
"pays": "US"
Comme vous pouvez le voir, le code d'état et statusText La propriété de l'objet JSON informe le client API que l'utilisateur a été ajouté avec succès. Les données ajoutées sont également renvoyées dans le Les données propriété de l'objet JSON. Vous pouvez configurer votre API comme vous le souhaitez.
Vous pouvez également mettre à jour un enregistrement existant à partir de la base de données du serveur API. le METTRE La requête HTTP est utilisée sur un point de terminaison d'API pour mettre à jour les données existantes sur la base de données de votre serveur d'API.
Par exemple, disons que vous souhaitez mettre à jour le numéro de téléphone de l'utilisateur avec l'identifiant 13. Vous pouvez faire un METTRE requête sur le point de terminaison de l'API /utilisateur/id/13.
"statutCode": 200,
"statusText": "Utilisateur mis à jour.",
"old_data":
"identifiant": 13,
"nom": "Marie Smith",
"âge": 35,
"téléphones": ["124-211-2341", "889-211-4545"],
"pays": "US"
,
"nouvelles données":
"identifiant": 13,
"nom": "Marie Smith",
"âge": 35,
"téléphones": ["100-211-1111", "140-211-1145"],
"pays": "US"
Comme vous pouvez le voir, l'opération de mise à jour est réussie. Les anciennes données et les nouvelles données sont renvoyées dans le anciennes_données et nouvelles données propriété de l'objet JSON respectivement.
Vous pouvez également supprimer des données de la base de données du serveur API avec le HTTP EFFACER requête sur le point de terminaison de l'API.
Par exemple, pour supprimer l'utilisateur avec l'id 12, vous pouvez faire un EFFACER requête sur le point de terminaison de l'API /utilisateur/id/12.
"statutCode": 150,
"statusText": "Utilisateur supprimé.",
"Les données":
"identifiant": 12,
"nom": "David Smith",
"âge": 42,
"téléphones": ["124-211-2341", "889-211-4545"],
"pays": "US"
Comme vous pouvez le voir, l'utilisateur est supprimé et les données utilisateur supprimées sont renvoyées dans le Les données propriété de l'objet JSON.
J'ai expliqué la manière standard d'utiliser le OBTENIR, PUBLIER, METTRE et EFFACER Requête HTTP sur les points de terminaison de l'API pour effectuer une opération CRUD (Créer, lire, mettre à jour et supprimer) à l'aide de l'API REST. Mais vous pouvez configurer votre API pour faire certaines choses sur certaines requêtes HTTP. Rien n'est réglé ici. Par exemple, vous pouvez mettre à jour l'API en utilisant OBTENIR requête HTTP. Vous n'êtes pas obligé d'utiliser METTRE. C'est au concepteur d'API.
Vous concevez également les points de terminaison de l'API. Donner des noms significatifs à vos points de terminaison d'API rend votre API REST beaucoup plus facile à utiliser.
Applications de l'API REST :
Les API rendent le développement d'applications plus simple et modulaire. Avec l'aide de l'API REST, vous pouvez facilement porter votre application sur différentes plates-formes.
Il ne vous reste plus qu'à concevoir et développer une API REST de votre application. Ensuite, vous pouvez utiliser votre API REST depuis votre site Web, votre application Android, votre application iOS, votre application de bureau Windows et votre application Linux, etc. De cette façon, toutes vos applications sur différentes plates-formes utiliseront la même logique et votre temps et vos coûts de développement seront réduits. Les applications seront également plus faciles à gérer. Les API REST sont également utilisées rapidement dans les applications Web à page unique de nos jours.
J'ai écrit un article sur l'écriture d'API REST à l'aide de Python. Merci d'avoir lu cet article.
