interface Web
js tutoriel
Codez votre première API avec Node.js et Express: Comprendre les API REST
Codez votre première API avec Node.js et Express: Comprendre les API REST
Mar 11, 2025 am 12:14 AM
dans le développement Web moderne, vous devez souvent les termes de repos et API. Si vous avez entendu parler de ces termes ou utilisé des API mais que vous ne comprenez pas complètement comment ils fonctionnent ou comment construire votre propre API, cette série de tutoriels vous convient.
Cette série de tutoriels décrira d'abord les principes et les concepts de repos. Nous allons ensuite créer une API complète qui s'exécute sur le serveur Node.js Express et se connecter à la base de données MySQL. Après avoir terminé cette série de tutoriels, vous devriez être en mesure de construire votre propre API en toute confiance ou de creuser dans la documentation pour les API existantes.
Prérequis
Pour tirer le meilleur parti de ce tutoriel, vous devriez avoir des connaissances de base de la ligne de commande, comprendre les bases de JavaScript et installer Node.js à l'échelle mondiale.
Quelles sont les API REST et RESTFULS?
Le transfert de l'état expressif ( rest ) décrit un style architectural de services Web. REST contient un ensemble de normes ou de contraintes pour partager des données entre différents systèmes. Le repos est un concept abstrait, pas une langue, un cadre ou un type de logiciel.
Une analogie lache sur le repos est: garder les collections d'enregistrements vinyles et utiliser des services de musique en streaming. Pour les collections d'enregistrements en vinyle physiques, chaque enregistrement doit être copié en entier afin de partager et de distribuer des copies. Cependant, pour les services de streaming, la même musique peut être partagée en permanence par référence à certaines données, telles que les titres de chansons. Dans ce cas, la musique en streaming est un service RESTful, tandis que la collection de disques vinyle est un service non re-rassin.
API est une interface de programmation d'applications, qui est une interface qui permet aux logiciels de communiquer entre eux. API RESTFul n'est qu'une API qui suit les principes et les contraintes de repos. Dans l'API Web, le serveur re?oit une demande via le point de terminaison de l'URL et renvoie une réponse , qui est généralement des données au format JSON.
principe de repos
six contraintes de guidage définissent l'architecture de rest comme suit:
- Interface unifiée : Les interfaces des composants doivent être les mêmes. Cela signifie utiliser la norme URI pour identifier les ressources - en d'autres termes, des chemins qui peuvent être entrés dans la barre d'adresse du navigateur.
- Client-Server : Il existe une séparation des préoccupations entre le serveur (Store and Operate Data) et le client (demande et réponse d'affichage).
- Interaction sans état : Toutes les informations sur chaque demande sont contenues dans chaque demande individuelle et ne dépend pas de l'état de session.
- CACHEABLE : Les clients et les serveurs peuvent mettre en cache des ressources.
- Système hydged : Les clients peuvent se connecter au serveur final ou à la couche intermédiaire, comme un équilibreur de charge.
- Code à la demande (facultatif) : Le client peut télécharger le code, réduisant ainsi la visibilité externe.
Demandes et réponses
Vous connaissez peut-être déjà les URL de toutes les sites Web à partir de HTTPS (version de sécurité). Le protocole de transfert hypertexte ( http ) est une méthode de communication entre les clients et les serveurs sur Internet.
Nous le voyons le plus évidemment dans la barre d'URL du navigateur, mais HTTP peut non seulement être utilisé pour demander des sites Web à partir du serveur. Lorsque vous accédez à une URL sur le Web, vous effectuez réellement Get et d'autres types de demandes.
http fait une demande en ouvrant une connexion TCP (protocole de contr?le de transport) au port du serveur (HTTP, HTTPS), et le serveur d'écoute renvoie l'état et le corps.
La demande doit contenir l'URL, la méthode, les informations d'en-tête et le corps.
Méthode de demande
Il existe quatre méthodes HTTP principales, également appelées verbes HTTP, qui sont couramment utilisés pour interagir avec l'API Web. Ces méthodes définissent les actions à effectuer sur une ressource donnée.
La méthode de la demande HTTP correspond approximativement à l'exemple crud , CRUD représente la création, la mise à jour, la lecture et la suppression . Bien que CRUD se réfère aux fonctions utilisées dans les opérations de base de données, nous pouvons appliquer ces principes de conception aux verbes http dans l'API RESTFul.
<code> curl -i https://www.google.com </code>
Le serveur de Google renvoie les éléments suivants:
<code> http / 2 200 Date: 21 ao?t 2022 19:06:22 GMT Expire: -1 CACE-Control: Private, Private, MAX-ISOCE = CHARSET; 859-1 ... </code>
Nous pouvons voir le code d'état 200, ainsi que la version de HTTP (ce sera HTTP / 1.1, HTTP / 2 ou HTTP / 3).
étant donné que cette demande particulière renvoie un site Web, il s'agit de texte / html. Dans l'API RESTFul, vous pouvez voir une demande de curl à Google (à l'exclusion de Google.com) renvoyant une réponse 301 indiquant que la ressource doit être redirigé.
REST API API Point de terminaison
Lorsqu'une API est créée sur le serveur, les données qu'il contient peuvent être accessibles via le point de terminaison. Endpoint est une URL qui peut accepter et traiter les demandes de posts et de supprimer les demandes. L'URL de l'API
se composera de racine, de chemin et de cha?ne de requête en option.
- root Par exemple, la racine de http://ipnx.cn/link/9fa87e1695a743c 29fa4 peut contenir des protocoles, des noms de domaine et des versions.
- chemin par exemple / utilisateurs / 5: le seul emplacement pour une ressource spécifique.
- Paramètres de requête (facultatif) Par exemple limite = 10, est utilisé pour filtrer la réponse pour ne contenir que dix résultats.
Par exemple, pour obtenir un utilisateur avec ID 5, nous utiliserons / utilisateur / 5.
Convention API REST
Les conventions suivantes doivent être suivies lors de la construction d'une API RESTful:
- Les points de terminaison ne devraient pas afficher les extensions de fichiers : bien que l'API soit la plus susceptible de retourner JSON, l'URL ne devrait pas se terminer en .json.
- Utilisez des noms au lieu de verbes : Par exemple, pour ajouter un utilisateur, nous devons utiliser le point de terminaison / utilisateurs et utiliser la demande de post au lieu du point de terminaison / users / ajouter. L'API doit être développée pour pouvoir gérer plusieurs types de demandes à la même URL.
- Les chemins sont sensibles à la casse et doivent utiliser des lettres et des traits de traits en minuscules au lieu de souligner: par exemple, / users-list est préférable à / users_list.
Toutes ces conventions guident les principes car il n'y a pas de normes de repos strictes à suivre. Cependant, l'utilisation de ces directives rendra votre API cohérente, familière et facile à lire et à comprendre.
Alternatives de repos
Le repos est un excellent outil, mais il existe certaines alternatives qui peuvent aider dans certains cas.
SOAP
SOAP (Simple Object Access Protocol) est une API créée en 1998 et était très populaire avant le repos. Il existe des différences majeures entre eux. Premièrement, le savon a des restrictions beaucoup plus strictes sur les formats de réponse. Deuxièmement, SOAP utilise XML au lieu de JSON, ce qui peut être utile pour les applications hérités, mais est généralement plus grand et plus complexe que JSON équivalent. Enfin, bien que SOAP fonctionne bien avec HTTP, il prend également en charge les protocoles tels que SMTP.
GraphQL
GraphQL est un format API plus récent créé par Facebook qui vise à réduire le nombre de demandes HTTP nécessaires pour obtenir les données en permettant aux clients de dire avec précision au serveur dont il a besoin. Au lieu d'utiliser des chemins d'url, GraphQL a une syntaxe personnalisée pour définir les données dont le client a besoin afin que le client obtienne tout ce dont il a besoin en une seule demande.
Pour une merveilleuse introduction à GraphQL, veuillez consulter ce didacticiel GraphQL.
Conclusion
Dans cet article, nous apprenons quelles sont les API de repos et de repos, comment les méthodes de demande HTTP et le fonctionnement du code de réponse, la structure des URL de l'API et les conventions API RESTful courantes. Dans le prochain tutoriel, nous apprendrons comment mettre toutes ces théories en pratique en configurant un serveur express avec Node.js et en construisant notre propre API.
Cet article a été mis à jour et comprend la contribution de Jacob Jackson. Jacob est développeur Web, écrivain technologique, freelancer et contributeur open source.
Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!
Outils d'IA chauds
Undress AI Tool
Images de déshabillage gratuites
Undresser.AI Undress
Application basée sur l'IA pour créer des photos de nu réalistes
AI Clothes Remover
Outil d'IA en ligne pour supprimer les vêtements des photos.
Clothoff.io
Dissolvant de vêtements AI
Video Face Swap
échangez les visages dans n'importe quelle vidéo sans effort grace à notre outil d'échange de visage AI entièrement gratuit?!
Article chaud
Outils chauds
Bloc-notes++7.3.1
éditeur de code facile à utiliser et gratuit
SublimeText3 version chinoise
Version chinoise, très simple à utiliser
Envoyer Studio 13.0.1
Puissant environnement de développement intégré PHP
Dreamweaver CS6
Outils de développement Web visuel
SublimeText3 version Mac
Logiciel d'édition de code au niveau de Dieu (SublimeText3)
Comment faire une demande HTTP dans Node.js?
Jul 13, 2025 am 02:18 AM
Il existe trois fa?ons courantes d'initier des demandes HTTP dans Node.js: utilisez des modules intégrés, Axios et Node-Fetch. 1. Utilisez le module HTTP / HTTPS intégré sans dépendances, ce qui convient aux scénarios de base, mais nécessite un traitement manuel de la couture des données et de la surveillance des erreurs, tels que l'utilisation de https.get () pour obtenir des données ou envoyer des demandes de post via .write (); 2.AXIOS est une bibliothèque tierce basée sur la promesse. Il a une syntaxe concise et des fonctions puissantes, prend en charge l'async / attendre, la conversion JSON automatique, l'intercepteur, etc. Il est recommandé de simplifier les opérations de demande asynchrones; 3.Node-Fetch fournit un style similaire à la récupération du navigateur, basé sur la promesse et la syntaxe simple
Types de données JavaScript: référence primitive vs
Jul 13, 2025 am 02:43 AM
Les types de données JavaScript sont divisés en types primitifs et types de référence. Les types primitifs incluent la cha?ne, le nombre, le booléen, le nul, un non défini et le symbole. Les valeurs sont immuables et les copies sont copiées lors de l'attribution des valeurs, de sorte qu'elles ne se affectent pas; Les types de référence tels que les objets, les tableaux et les fonctions stockent les adresses de mémoire, et les variables pointant vers le même objet s'afferchent mutuellement. Le typeof et l'instance de OFF peuvent être utilisés pour déterminer les types, mais prêtent attention aux problèmes historiques de typeofnull. Comprendre ces deux types de différences peut aider à écrire un code plus stable et fiable.
React vs Angular vs Vue: Quel framework JS est le meilleur?
Jul 05, 2025 am 02:24 AM
Quel framework JavaScript est le meilleur choix? La réponse est de choisir la plus appropriée selon vos besoins. 1.RIATT est flexible et gratuit, adapté aux projets moyens et grands qui nécessitent une personnalisation élevée et des capacités d'architecture d'équipe; 2. Angular fournit des solutions complètes, adaptées aux applications au niveau de l'entreprise et à la maintenance à long terme; 3. Vue est facile à utiliser, adaptée à des projets de petite et moyenne taille ou à un développement rapide. De plus, s'il existe une pile technologique existante, la taille de l'équipe, le cycle de vie du projet et si le RSS est nécessaire sont également des facteurs importants dans le choix d'un cadre. En bref, il n'y a pas absolument le meilleur cadre, le meilleur choix est celui qui convient à vos besoins.
Objet JavaScript Time, quelqu'un construit un site Web Eactexe, plus rapide sur Google Chrome, etc.
Jul 08, 2025 pm 02:27 PM
Bonjour, développeurs JavaScript! Bienvenue dans JavaScript News de cette semaine! Cette semaine, nous nous concentrerons sur: le différend de marque d'Oracle avec Deno, les nouveaux objets Time JavaScript sont pris en charge par les navigateurs, les mises à jour Google Chrome et certains outils de développeurs puissants. Commen?ons! Le différend de marque d'Oracle avec la tentative de Deno Oracle d'enregistrer une marque "JavaScript" a provoqué la controverse. Ryan Dahl, le créateur de Node.js et Deno, a déposé une pétition pour annuler la marque, et il pense que JavaScript est un niveau ouvert et ne devrait pas être utilisé par Oracle
Qu'est-ce que l'API Cache et comment est-elle utilisée avec les travailleurs du service?
Jul 08, 2025 am 02:43 AM
Cacheapi est un outil fourni par le navigateur pour mettre en cache les demandes de réseau, qui est souvent utilisée en conjonction avec travailleur de service pour améliorer les performances du site Web et l'expérience hors ligne. 1. Il permet aux développeurs de stocker manuellement des ressources telles que des scripts, des feuilles de style, des photos, etc.; 2. Il peut faire correspondre les réponses du cache en fonction des demandes; 3. Il prend en charge la suppression des caches spécifiques ou la nettoyage du cache entier; 4. Il peut mettre en ?uvre des stratégies de priorité de cache ou de priorité de réseau grace à l'écoute des événements Fetch; 5. Il est souvent utilisé pour le support hors ligne, accélérez la vitesse d'accès répétée, préchargement des ressources clés et du contenu de mise à jour des antécédents; 6. Lorsque vous l'utilisez, vous devez faire attention au contr?le de la version du cache, aux restrictions de stockage et à la différence entre le mécanisme de mise en cache HTTP.
Gestion des promesses: cha?nage, gestion des erreurs et combinateurs de promesses en javascript
Jul 08, 2025 am 02:40 AM
La promesse est le mécanisme central pour gérer les opérations asynchrones en JavaScript. Comprendre les appels de cha?ne, la gestion des erreurs et les combinants est la clé pour ma?triser leurs applications. 1. L'appel de la cha?ne renvoie une nouvelle promesse à travers. Puis () pour réaliser la concaténation des processus asynchrones. Chaque .then () re?oit le résultat précédent et peut renvoyer une valeur ou une promesse; 2. La gestion des erreurs doit utiliser .catch () pour attraper des exceptions pour éviter les défaillances silencieuses, et peut renvoyer la valeur par défaut dans Catch pour continuer le processus; 3. Combinateurs tels que promesse.all () (réussi avec succès uniquement après tout succès), promesse.race () (le premier achèvement est retourné) et promesse.allsetTled () (en attente de toutes les achèvements)
Tire de tirage.
Jul 06, 2025 am 02:36 AM
Des méthodes intégrées de la matrice JavaScript telles que .map (), .filter () et .reduce () peuvent simplifier le traitement des données; 1) .map () est utilisé pour convertir les éléments un en un pour générer de nouveaux tableaux; 2) .filter () est utilisé pour filtrer les éléments par condition; 3) .reduce () est utilisé pour agréger les données en tant que valeur unique; Une mauvaise utilisation doit être évitée lorsqu'elle est utilisée, entra?nant des effets secondaires ou des problèmes de performance.
JS Roundup: une plongée profonde dans la boucle d'événement JavaScript
Jul 08, 2025 am 02:24 AM
La boucle d'événement de JavaScript gère les opérations asynchrones en coordonnant les piles d'appels, les webapis et les files d'attente de taches. 1. La pile d'appels exécute du code synchrone, et lors de la rencontre de taches asynchrones, il est remis à WebAPI pour le traitement; 2. Une fois que le WebAPI a terminé la tache en arrière-plan, il met le rappel dans la file d'attente correspondante (macro tache ou micro tache); 3. La boucle d'événement vérifie si la pile d'appels est vide. S'il est vide, le rappel est retiré de la file d'attente et poussé dans la pile d'appels pour l'exécution; 4. Micro taches (comme Promise. puis) ??prendre la priorité sur les taches macro (telles que Settimeout); 5. Comprendre la boucle d'événements permet d'éviter de bloquer le thread principal et d'optimiser l'ordre d'exécution du code.
