Réponse du serveur et types de données

La réponse qui provient du serveur fonctionne presque selon le même schéma que la demande. Pour des raisons évidentes, elle n'a pas de paramètres de demande, mais les en-têtes et le corps sont inclus dans la réponse (bien qu'ils puissent être vides).

Une différence importante est le statut de la réponse.

Codes d'état

Code d'état. Il figure sur la première ligne de la réponse du serveur. Le statut est un nombre à trois chiffres (le code lui-même), suivi d'une phrase explicative.

C'est par le code d'état que vous pouvez connaître les résultats de la demande et comprendre quelles actions doivent être entreprises ensuite.

Tous les codes d'état possibles sont répartis en 5 classes. Le premier chiffre du code détermine l'appartenance à une classe particulière. Décomposons-les.

1xx - codes d'information. Ils signalent l'état d'avancement de la demande. Dans la pratique, ils sont rarement utilisés.

2xx - codes de réussite. Ils signalent que tout est en ordre et que la demande a été traitée avec succès. En réponse à une demande GET, nous nous attendons généralement à recevoir un code 200 (OK). Une demande PUT réussie envoie un code 201 (Created).

3xx - redirections. Indique que la demande doit être envoyée à une autre adresse. Le code 301 (Moved Permanently), par exemple, indique que les données requises se trouvent désormais à une nouvelle adresse (la nouvelle adresse elle-même est transmise dans l'en-tête Location).

4xx - codes d'erreur du client. Le plus connu d'entre eux - 404 (Not Found), signale qu'il n'y a pas de données nécessaires à l'adresse spécifiée. Autres cas courants : 400 (Bad Request, erreur de syntaxe dans la demande), 401 (Unauthorized, authentification requise pour l'accès), 403 (Forbidden, accès refusé).

5xx - codes d'erreur du serveur. Signale une erreur du côté du serveur. Par exemple : 500 (Internal Server Error, toute erreur incompréhensible qui ne peut être attribuée à un code connu), 503 (Service Unavailable, le serveur est temporairement incapable de traiter la demande pour des raisons techniques).

Types de données

À ce stade, nous pouvons supposer que nous avons traité les informations de base pour comprendre l'API REST et la structure des demandes et réponses HTTP. Il ne reste plus qu'à clarifier un seul point : les types de données. Si vous avez déjà essayé de créer votre demande API dans AppMaster, vous avez probablement remarqué que toutes les données (dans les paramètres, dans les en-têtes, dans le corps) vous demande de spécifier non seulement le nom, mais aussi le type de données.

Il est généralement assez évident pour un humain comment travailler avec les données, car il y a un certain contexte. Supposons que nous sachions que 2 + 2 = 4. Nous supposons qu'il s'agit de nombres et que le résultat de l'addition sera un autre nombre.

Mais il se peut qu'il ne s'agisse pas de nombres, mais de données textuelles. Alors le résultat de leur addition pourrait être la concaténation de chaînes de caractères et 2 + 2 se transformerait en "22". Ici, pour que l'ordinateur n'ait pas à penser à quoi que ce soit, il y a une indication exacte du type de données. Et en même temps, d'autres tâches sont résolues. Par exemple, une protection est assurée contre la saisie de données incorrectes ; initialement, il n'est pas possible d'enregistrer une adresse électronique dans le champ destiné à la saisie des chiffres d'un numéro de téléphone.

Il existe un grand nombre de types de données différents, nous allons maintenant considérer les plus basiques, et dans les modules suivants du cours, nous nous familiariserons avec le reste.

String - Type de données String, texte brut sans formatage spécial.

Integer - Type de données Integer. Peut être utilisé pour les compteurs ou les calculs où les nombres fractionnaires ne sont pas nécessaires.

Float - Nombre à virgule flottante. Il est utilisé lorsqu'une précision accrue est nécessaire et que les valeurs entières ne suffisent pas.

Une question logique peut se poser ici. Pourquoi ne pas toujours utiliser Float, pourquoi avons-nous besoin d'Integer alors ? Mais une plus grande précision nécessite plus de ressources. Pour certains petits calculs, cela peut être totalement invisible, mais dans le cas de grandes quantités de données, l'utilisation d'un type de données raisonnable peut réduire considérablement les besoins en puissance de calcul et en espace disque.

Booléen - type de données booléen. Le type de données le plus simple. Il prend l'une des deux valeurs suivantes, qui s'écrivent comme Vrai ou Faux. Vous pouvez souvent voir la désignation sous la forme de 1 (vrai) et 0 (faux).