Site icon Blog ARC Optimizer

Un guide pour les chefs de produit


À propos de l'auteur

Mike Sędzielewski est cofondateur de Voucherify et rspective . Il vit à Katowice, en Pologne et écrit sur les plateformes «sans tête» et la technologie marketing.
Pour en savoir plus sur Michał

Les solutions basées sur des API deviennent un élément essentiel des produits numériques modernes. Que sont-ils? Comment peuvent-ils influer sur votre processus de conception? Enfin, comment les évaluer sans déranger votre équipe de logiciels?

Construire un produit numérique aujourd'hui, c'est intégrer la multitude de systèmes de back-office aux points de contact et aux périphériques des clients. Le coût de faire appel à une équipe logicielle pour les connecter au sein d'une solution unique peut exploser.

C'est pourquoi les gestionnaires de produits modernes, lorsqu'ils choisissent des fournisseurs, accordent souvent la priorité aux capacités d'intégration, ce qui revient parfois à choisir des systèmes API. En quoi consiste l’API et comment la tester sans engager votre équipe technique?

Embrassez les données: nous avons absolument besoin des API

Les données des clients modifient le fonctionnement de l'entreprise. Si elles sont correctement collectées et déplacées, elles peuvent aider les entreprises à augmenter les taux d'acquisition et de fidélisation de leurs clients, entraînant éventuellement une augmentation des revenus.

Mais le traitement des données est un travail fastidieux. C’est pourquoi les entreprises ont eu recours à l’informatique. Dans les années 1990, les bases de données qui automatisaient les tâches de données les plus chronophages sont devenues très populaires dans tous les services de marketing. Cela a conduit à un changement radical dans la conception des stratégies marketing – ce changement a été appelé l'approche pilotée par les données .

Cependant, les bases de données avaient un inconvénient majeur. Pour en faire quelque chose de précieux, une entreprise devait engager des ingénieurs en logiciel. Ce sont ces héros qui ont su transformer d’énormes piles de données en informations utiles. Ils étaient également les gardiens qui protégeaient l’intégrité des données et assuraient ainsi la pérennité du système.

Mais les ingénieurs en logiciels coûtaient cher et leur interface de communication demandait des efforts.

Lorsque le nombre de canaux de collecte de données couvrait plusieurs départements et même les sociétés externes, les bases de données et leurs opérateurs sont devenus un goulot d'étranglement. Les entreprises devaient trouver un moyen automatisé d’accéder aux magasins de données.

C’est ainsi qu'est née l’idée des premiers systèmes d’API.

Ce que l’API est en réalité sans le jargon technologique

Les systèmes API-first, couramment abrégés aujourd’hui en API ( A [Application P Rogrammable I (interface), sont les applications qui permettent aux autres systèmes d'accéder à leurs données de manière unifiée et sécurisée.

Sans grade informatique, Application programmable L'interface ne sonne pas vraiment. Voyons une explication plus concrète.

L’une des meilleures analogies que j’ai trouvées sur le Web jusqu’à présent a été écrite par Taija :

"Si vous allez dans un restaurant un client, vous n'êtes pas autorisé à entrer dans la cuisine. Vous devez savoir ce qui est disponible. Pour cela, vous avez le menu. Après avoir regardé le menu, vous commandez un serveur, qui le passe à la cuisine et qui vous livrera ensuite ce que vous avez demandé. Le serveur ne peut livrer que ce que la cuisine peut fournir.

Quel est le lien avec une API? Le serveur est l'API. Vous êtes quelqu'un qui demande un service. En d'autres termes, vous êtes un client ou un consommateur API. Le menu est la documentation qui explique ce que vous pouvez demander à l’API. La cuisine est, par exemple, un serveur; une base de données qui ne contient qu'un certain type de données – tout ce que l'acheteur a acheté pour le restaurant en tant qu'ingrédients et ce que le chef a décidé d'offrir et ce que les cuisiniers savent comment préparer. "

Encore une fois:

  • Cuisine
    La base de données, aucun client n'est autorisé à protéger l'intégrité des données.
  • Waiter
    L'API, un intermédiaire qui sait comment servir les données de la base de données sans en perturber le fonctionnement.
  • Client
    Un système externe qui veut obtenir leurs données
  • Menu

    La référence de format de données que les systèmes externes doivent utiliser pour exécuter leurs opérations.

  • Ordonnance
    Un appel unique à API réel.

Avec l'état actuel de la technologie , il faut encore un développeur de logiciel pour «passer une commande». Mais c’est beaucoup plus rapide (lire: moins cher) car le menu, comme McDonald, est plus ou moins normalisé à travers le monde.

Nous allons maintenant passer à porter les chaussures d'un développeur de logiciels et essayer d'appeler une API exemplaire. Ne vous inquiétez pas nous n'allons pas au-delà des cours d'informatique à l'école.

Comment votre application météo obtient-elle les données: Notions de base sur l'API

Nous allons découvrir comment votre application météo connaît la température actuelle. De cette façon, nous aurons les bases de la communication avec les systèmes via Internet.

Ce dont nous avons besoin:

  • Une base de données météo
  • Un navigateur
  • Un soupçon de volonté

C'est tout ! La technologie actuelle facilite le test de l'API sans recourir à de gros outils de développement.

Bien sûr, il en va différemment lorsque vous souhaitez créer une intégration complète. Lorsque les choses se bousculent, vous devez connaître des outils et des langages de programmation plus avancés, mais pour les tests / preuves de concepts, cette configuration est suffisante.

Essayons donc d’obtenir l’indice de température actuel de votre ville ou de votre ville. le jargon des codeurs – appelons le premier appel API. Après tout, cela revient à envoyer du texte à un serveur et recevoir un message en échange .

L’anatomie d’une demande d’API

Dans cet article, nous utiliserons le . ] https://openweathermap.org API. Visitez le site et essayez de vérifier les conditions météorologiques à plusieurs endroits. Espérons que vous vous sentiez mieux que moi à Katowice aujourd’hui:


Widget API Carte météo ouverte ( Grand aperçu )

Comme vous l'avez peut-être deviné, le site Web appelle l'API pour obtenir les données. Les développeurs l'ont implémentée de manière à ce que chaque fois que vous appuyez sur search l'application frappe en coulisse l'application de l'API et indique «donnez-moi la température ».

Mettons un chapeau de pirate informatique et voyons l'API appelle ce site appelle avec votre navigateur. Vous pouvez utiliser les outils de développement de votre navigateur pour voir ce qui se passe dans les coulisses:

  1. Sous Chrome, sélectionnez Menu → Autres outils → Outils de développement;
  2. sur l'onglet Réseau;
  3. . Essayez de vérifier la température dans différentes villes de le widget ci-dessus;
  4. Dans la liste du bas, vous remarquerez des liens qui s'appellent:

    Moniteur de requêtes dans les outils de développeur Chrome ( Grand aperçu )

    Si vous copiez le lien, vous remarquerez qu'il comprend le nom de l'emplacement et quelques autres paramètres. = 30 & appid = b6907d289e10d714a6e88b30761fae22 & _ = 1542285819418
      

  5. Lorsque vous collez le lien dans la barre d'adresse du navigateur, les réponses de l'API doivent s'afficher comme suit:
     jQuery191038879578001505_1542285819413 ({"message": "précis", "cod": "200", "compte": 1, "liste": [{"id":3096472,"name":"Katowice","coord":{"lat":50.2599,"lon":19.0216},"main":{"temp":281.69,"pressure":1031,"humidity":61,"temp_min":281.15,"temp_max":282.15},"dt":1542285000,"wind":{"speed":3.6,"deg":50},"sys":{"country":"PL"},"rain":null,"snow":null,"clouds":{"all":90},"weather":[{"id":804,"main":"Clouds","description":"overcast clouds","icon":"04d"}]}]})
     
  6. C’est un peu chaotique, mais si vous supprimez le contenu des parenthèses et que vous l’exécutez avec un formateur de données vous verrez une structure logique:
     {
       "message": "précis",
       "cod": "200",
       "compter": 1,
       "liste":[
          {
             "id": 3096472,
             "nom": "Katowice",
             "coord": {
                "lat": 50,2599,
                "lon": 19.0216
             },
             "principale":{
                "temp": 281,69,
                "pression": 1031,
                "humidité": 61,
                "temp_min": 281.15,
                "temp_max": 282.15
             },
             "dt": 1542285000,
             "vent":{
                "vitesse": 3.6,
                "deg": 50
             },
             "sys": {
                "pays": "PL"
             },
             "pluie": null,
             "neige": null,
             "des nuages":{
                "tous": 90
             },
     
  7. La réponse de l'API est une structure de données contenant des informations sur les conditions météorologiques actuelles. Vous devez facilement décrypter la plupart des paramètres. Ce format de données s'appelle JSON . C'est une notation importante car la plupart des API modernes l'utilisent. Cette pile d'identificateurs et de crochets sert un objectif: il est plus facile pour une application d'analyser un message bien structuré qu'un texte placé de manière aléatoire.

Explication de ce que nous venons de faire ici.

L'application Web derrière le site Web Open Weather Map prend les données de l’API et les affiche sur le site Web.

Chaque fois que vous tapez le nom de la ville et que vous appuyez sur search le site Web se connecte à un serveur avec un lien spécifique. inclut le nom de la ville en tant que paramètre.

La même phrase du jargon technologique: l’application située derrière le site Web envoie une demande à un point final de l’API en indiquant le nom du ville comme argument .

Ensuite, l'API répond (envoie une réponse API ) avec un message au format JSON .


Webapp Diagramme de base de données ( Grand aperçu )

Pour créer une demande d'API, vous devez rassembler son adresse. Oui, l'adresse est une bonne analogie. Pour envoyer quelque chose, vous devez fournir au service de messagerie:

  • Ville,
  • Rue et numéro,
  • Parfois, quelques informations supplémentaires sur la procédure à suivre pour vous rendre à votre bureau.

Et, pour vous connecter à l'API, par l'analogie, vous avez besoin de:

  • https://openweathermap.org/ ( link )
    La ​​ville ou le point racine: un point de départ, une adresse Internet d'un le serveur auquel vous souhaitez vous connecter, dans notre cas.
  • data / 2.5 / find ( link )
    Le numéro de la rue ou le chemin – détermine la ressource que vous souhaitez utiliser. obtenir de l'ivoire Indiquez au serveur d'API ce que vous souhaitez obtenir en particulier, ainsi que la structure et l'ordre des données.

Voici comment les API re conçu. Le point de terminaison racine reste généralement le même pour un seul fournisseur. Vous devez ensuite déterminer quel chemin et quels paramètres de requête sont disponibles et quelles informations l’équipe de développement des API a cachées derrière eux.

Maintenant, mettons un peu plus fort le chapeau de pirate informatique. Dans notre cas, tous les paramètres de la requête ne sont pas nécessaires pour obtenir les données météorologiques. Essayez de supprimer différents paramètres après le point d'interrogation (? ) et vérifiez comment répond l'API météo.

Par exemple, vous pouvez commencer par supprimer de rappel du lien de demande:

. ]

 https://openweathermap.org/data/2.5/find?callback=jQuery1910389

Le résultat:

 https://openweathermap.org/data/2.5/find?q=Katowice&type=like&sort=population&cnt=30&appid=b6907d289e10d714a6e88b30761fae22&_=1542285819418

Si vous jouez avec les autres, vous pouvez voir que certains d'entre eux sont aussi facultatifs. En réalité, seuls q et appid sont obligatoires:

 https://openweathermap.org/data/2.5/find?q=Katowice&appid=b6907d289e10d714a6e88b30761fae22

Comment savez-vous ce qui est obligatoire et ce qui est facultatif? Comment savoir où obtenir le point de terminaison racine et le chemin d'accès en premier lieu?

Documentation de l'API: Une lecture impérative avant de commencer

Vous devez toujours consulter la documentation de l'API en premier pour Apprenez à construire votre requête dans le bon sens.

Dans notre cas, la documentation https://openweathermap.org/current indique les points d'extrémité disponibles. Il explique également tous les champs de données de réponse – afin que vous puissiez trouver les informations auxquelles l'API répondra avant même d'envoyer une demande.

Une bonne documentation de l'API propose des didacticiels de démarrage rapide sur la création de demandes simples et le passage à des tâches plus avancées. . Heureusement, l’API Open Weather en a un et nous allons l’utiliser maintenant

Créer un appel API à partir de rien

Résumons nos résultats. Nous avons déjà envoyé une demande à l'API. Nous avons trouvé le bon lien en détectant ce que OpenWeatherMap fait en coulisse. Cette approche s’appelle de la rétro-ingénierie et est souvent difficile, voire impossible.

De plus, les fournisseurs d’API interdisent aux utilisateurs de sur-utiliser cette option. C’est pourquoi nous devrions apprendre à “appeler” l’API par les règles (signification – documentation).

L’une des façons de le faire est de la coder. Mais comme nous ne sommes pas encore codeurs (! ), nous allons utiliser des outils facilitant cette tâche. Tellement plus facile que même les développeurs de logiciels l’ont sous la ceinture d’outils.

Comme promis, nous ne quitterons pas le navigateur. Mais nous devons installer une extension (Chrome uniquement) – Postman . Ce simple plugin transforme votre navigateur en connecteur API.


Vue principale de Postman ( Grand aperçu )

OK, maintenant que nous avons un outil, examinons la documentation pour voir comment obtenir les conditions météorologiques actuelles pour un nom de ville spécifique https://openweathermap.org/current#name

Les ddocs disent que nous devrions utiliser le point final suivant: api.openweathermap.org/data/2.5/weather?q= {nom de la ville}

Lorsque nous la décomposons, nous obtenons ce qui suit. elements:

  • Racine-endpoint: api.openweathermap.org
  • Chemin: data / 2.5 / weather
  • Paramètre de requête: q = {nom de la ville } (cette notion signifie que nous devrions remplacer les accolades par un nom de ville spécifique)

Mettons-le dans Postman. Le processus se résume en trois étapes faciles:

  1. Cliquez sur "Demande" dans le menu supérieur.

    Vue de la nouvelle demande Postman ( Grand aperçu )
  2. Nommez votre demande et indiquez le nom du catalogue dans la section située en bas.
      

    Vue du nom de la requête du postier ( Grand aperçu )
  3. Collez le point de terminaison de l'API que vous souhaitez appeler, cliquez sur Envoyer et vous devriez voir la réponse de l'API dans la section Réponse:
      

    Envoi de la première demande à Postman ( Grand aperçu )

Félicitations! Vous venez d’appeler votre sapin avec succès… attendez une seconde! Faisons attention à la réponse de l’API:


Exemple de réponse invalide ( Grand aperçu )

Ce n’est pas un JSON rempli d’informations météorologiques que nous avons vues auparavant. Que signifient les clés API 401 et Invalid?

Authentification

Vous ne laisseriez personne accéder à votre armoire à cocktails sans votre permission, n'est-ce pas? De même, les fournisseurs d’API souhaitent également contrôler les utilisateurs de leur produit afin de le protéger contre les activités malveillantes. Quelle est l’activité malveillante? Par exemple, l'envoi simultané de plusieurs requêtes d'API, ce qui «surchauffera» le serveur et entraînera des temps d'arrêt pour les autres utilisateurs.

Comment contrôler l'accès? De la même manière que vous gardez vos boissons! Utilisation de clés – Clés de l’API .

Si vous visitez le guide Comment démarrer à partir de la documentation de l’API Weather, vous remarquerez comment obtenir votre clé. Inscrivez-vous maintenant et vérifiez votre boîte de réception.

Alors maintenant, la question est de savoir comment utiliser la clé? Selon la documentation, il est facile de copier et coller la clé à la fin de l’URL de votre terminal (sans accolades).

 api.openweathermap.org/data/2.5/weather?q=Katowice&appid= {votre clé d’API}

Et cliquez sur envoyer à nouveau. Voilà, nous pouvons maintenant voir la réponse de l'API! ?


Réponse réussie de l'API Open Weather Map ( Grand aperçu )

Mais vous pouvez obtenir beaucoup plus de l’API avec Postman. Êtes-vous prêt à devenir un véritable hacker de l'API?

Paramètres de l'API: Obtenir des réponses personnalisées

Les points de terminaison de l'API possèdent généralement certaines fonctionnalités utiles que vous pouvez utiliser pour ajuster la réponse de l'API, par exemple. si vous avez besoin d'un meilleur format de données ou si vous souhaitez obtenir les données dans un ordre particulier. Ces options sont souvent cachées derrière certains paramètres que vous trouverez dans la documentation.

Les paramètres de requête ne sont qu'un texte structuré que vous ajoutez à l'adresse du noeud final avec le motif suivant:

  1. Un point d'interrogation (? ) après le chemin,
  2. Nom d’un paramètre,
  3. Symbole ( = ), symbole
  4. valeur du paramètre,
  5. Ampersand ( & ), et d'autres suivent avec les points 2 à 4 (de cette façon, vous pouvez ajouter autant de paramètres que vous le souhaitez).

Prenez notre première demande à titre d'exemple:

 https://openweathermap.org/data/2.5/find?q=Katowice&appid=b6907d289e10d714a6e88b30761fae22

Note importante: L’ordre des paramètres de requête n’a pas d’importance.

? Q = Katowice & appid = b6907d289e10d714a6e88b30761fae22

Ce qui précède est identique à ce qui suit:

? Appid = b6907d289e10d714a6e88b30761fae22 & q = Katowice

Comme mentionné, les paramètres de requête sont décrits dans la documentation de l'API. L'extrait suivant de la documentation de l'API météorologique indique comment obtenir la température en unités différentes (impériale ou métrique):


Extrait de la documentation de l'API OpenWeatherMap ( de grand aperçu )

Essayez d'envoyer ces deux options avec Postman pour voir la différence de résultats. N'oubliez pas d'ajouter votre clé API à la fin de l'adresse du noeud final.

Note : Prenez toujours le temps d'étudier la documentation et de trouver des paramètres permettant de gagner un temps précieux pour vous et votre équipe de développement. .

Options de demande d'API: Comment envoyer des données à l'API

Jusqu'à présent, nous avons eu des informations à partir de l'API. Que faire si nous voulons ajouter ou modifier des informations dans la base de données derrière l'API? Les méthodes de requête sont la solution.

Revenons à Postman. Vous avez peut-être remarqué une étiquette GET en majuscule à côté de l'adresse du point de terminaison de l'API. Cela représente l'une des quatre méthodes de demande. GET signifie que nous voulons obtenir quelque chose de l’API (merci capitaine) et qu’il s’agit d’une option par défaut. Quelles sont les autres options?

Nom de la méthode Effets sur l'API
GET L'API recherche les données que vous avez demandées et vous les renvoie.
POST [19659158] L’API crée une nouvelle entrée dans la base de données et vous indique si la création est réussie.
PUT L’API met à jour une entrée de la base de données et vous indique si la mise à jour a abouti.
DELETE L'API supprime une entrée dans la base de données et vous indique si la suppression est réussie.

Toujours déroutant? Passons maintenant aux exemples.

API POST: Comment créer un enregistrement dans l'API

Il est impossible de créer ou de mettre à jour quoi que ce soit avec Weather API (car il est censé être en lecture seule). différent pour les tests.

Imaginons un exemple plus orienté entreprise. Nous allons simuler le scénario suivant:

S'il pleut, créez un coupon de réduction «égayez-le» pour vos clients.

Nous allons utiliser Voucherify qui fournit une API à création et suivi des promotions pour tout système de commerce électronique.

Disclaimer : Je suis co-fondateur de Voucherify. Je suis heureux de répondre à vos questions sur la conception et la mise en œuvre de promotions numériques et sur notre API, bien sûr . ?

Nous savons déjà comment les récupérer à partir de l'exemple précédent, nous allons donc nous concentrer sur la création d'un bon:

  1. Comme nous l'avons dit, nous devrions toujours commencer par la documentation .
  2. Le guide de démarrage rapide nous indique comment obtenir notre clé API.
    Note : Au lieu de créer un compte, vous pouvez utiliser les clés de test du guide de démarrage rapide - nous allons vous montrer comment faire en une minute.
  3. Voyons maintenant comment créer un coupon de réduction. Dans Voucherify, ce type de promotion est représenté par « voucher ».
  4. Dans la documentation, vous apprendrez que pour créer un voucher vous devez appeler une méthode POST pour / vouchers endpoint.
  5. Créer une nouvelle demande dans Postman.
  6. Modifier la méthode en POST.

    Postman - Sélection de méthodes API ( Grand aperçu )
  7. Collez le point final Voucherify https://api.voucherify.io/v1/vouchers/ et cliquez sur Envoyer.

    Identifiants manquants [1965948] ] Grand aperçu )
  8. Oh snap, nous n’avons pas le droit d’appeler ce point final. Comme vous l'avez peut-être deviné, nous devons fournir des clés d'API.

    Voucherify utilise une méthode légèrement différente. Au lieu de les utiliser comme paramètres de requête, vous devriez les mettre dans les en-têtes. Cette approche est courante car il est plus facile d’implémenter et de gérer des clés de cette façon plutôt que de les ajouter en tant que paramètres de requête.

    Ajoutez les clés comme dans l’image, puis cliquez sur Envoyer. Notez que Voucherify nécessite deux clés. Voici ceux que vous pouvez utiliser aux fins de ce tutoriel:
    X-App-Id: 8a824b12-0530-4ef4-9479-d9e9b9930176
    X-App-Token: 9e322bac-8297-49f7-94c8-07946724cbcb 19659189] Fourniture de clés API dans Postman "/>

    Fourniture de clés API dans Postman ( Grand aperçu )

  9. Nous recevons un autre message d'erreur, cette fois-ci, le contenu ne peut pas être vide.

    L'API Voucherify renvoie le code d'erreur 400 ( Grand aperçu )

    Qu'est-ce que c'est qu'une charge utile? Comme dans le cas de GET, nous voulons récupérer certaines informations. Avec POST, nous devons envoyer quelque chose et le message que nous envoyons s'appelle la charge utile et il s'agit généralement d'un fichier JSON.

    Maintenant, l'API Voucherify se plaint de ne pas avoir fourni cette information. un, ce qui signifie qu’il ne peut pas créer de voucher parce que nous ne disons pas quel type de voucher il devrait créer. Alors quoi maintenant? Retour aux documents!

  10. Voyons quel type d’information cette demande doit avoir pour réussir. Nous pouvons voir beaucoup d'options sur la liste .

    Extrait de la documentation de l'API Voucherify ( Grand aperçu )

    Un paramètre (type) est requis et un autre facultatif. Disons que ce sera un rabais de 20%, disponible pour les 100 premiers clients, expirant aujourd’hui. Nous devons maintenant trouver les paramètres responsables de ces fonctionnalités et les regrouper dans un format compréhensible pour l’API Voucherify. Comme vous pouvez le constater dans les exemples ci-dessus, la notation JSON à utiliser se présente comme suit:
      

     {
        "type": "DISCOUNT_VOUCHER",
        "remise":{
            "percent_off": 20.0,
            "type": "POUR CENT"
        },
        "expiration_date": "2018-12-03T23: 59: 59Z",
        "rachat":{
            "quantité": 100
        }
     
  11. Pour configurer la charge utile dans Postman, collez le message JSON dans l'onglet Corps. Sélectionnez le type "raw" et le JSON dans la liste des formats de charge utile disponibles et confirmez avec Envoyer.

    Méthode POST dans Postman ( Grand aperçu )
  12. Voilà! Voucherify a créé avec succès notre coupon de réduction de 20% (étant donné que nous travaillons avec un compte test, tous les codes générés commencent par le préfixe "voucherify.io-"). L’équipe marketing peut désormais partager le code avec les clients et Voucherify le validera automatiquement chaque fois qu’ils se rendront dans votre magasin pour l’échanger.

    Voucherify renvoie 200 OK ( Grand aperçu )

    Mais comment savons-nous que la demande a été acceptée? Tout d'abord, nous pouvons voir que Voucherify nous a envoyé un message qui, selon leurs documents, ressemble à une réponse d'API correcte. Deuxièmement, Postman affiche le statut 200 OK - ce qui signifie que notre demande a abouti. Pourquoi 200 et quel est le statut?

Codes d’état des API et messages d’erreur

La plupart des API avec lesquelles vous allez interagir seront basées sur HTTP. Le protocole HTTP est un protocole qui normalise la communication entre diverses applications clientes et serveurs sur Internet.

L'un des éléments clés du protocole HTTP est le code d'état. En comprenant le code de statut, vous (ou les systèmes que vous implémentez) pouvez immédiatement savoir ce qui est arrivé à votre demande. Vous avez probablement rencontré l'un des codes de statut les plus populaires lorsque vous avez saisi le mauvais lien - 404


Code d'erreur Voucherify 404 ( Grand aperçu )

Mais il y en a beaucoup plus et les utilisateurs finaux ne les voient généralement pas. Ils vont de 100+ à 500+. En général, les numéros suivent les règles suivantes:

  • 200+ signifie que la requête a abouti;
  • 300+ signifie que la requête est redirigée vers une autre URL;
  • 400+ signifie qu'une erreur provenant de l'application client a
  • Plus de 500 signifie qu'une erreur provenant du serveur s'est produite.

Si vous pouviez répéter les étapes une fois de plus, vous verriez que Voucherify a répondu avec 401 Unauthorized sans nous fournir les clés d'API. Ou 400 Bad Request lorsqu'il n'y avait pas de charge requise pour la demande de création d'un voucher. Enfin, nous en avons reçu 200 comme un appel réussi à l'API.

Si vous êtes curieux de connaître le sens des codes d'état HTTP, il n'y a pas de meilleur endroit que HTTP Cats (ou cet article ] peut être). ?


HTTP Cats 401 ( Grand aperçu )

Résumé

La ​​quantité croissante de données et le besoin de rapidité dans la fabrication de produits ont poussé les API à devenir la lingua franca des équipes numériques. Pour concevoir des systèmes basés sur les systèmes d’API, assurez-vous de bien comprendre les offres des fournisseurs. Ce guide de test pratique est un bon point de départ pour le faire. Cela vous aidera à explorer les fonctionnalités de l'API avant même de la confier à votre équipe pédagogique, ce qui vous permettra d'économiser leur énergie - et la vôtre également.

Pour en savoir plus

Quitter la version mobile