Aller au contenu principal

Environnement web (serveur), les APIs

« Un site web n’est pas obligé d’avoir des APIs.
Les APIs sont là pour tous les logiciels autres que les navigateurs qui accèdent à internet »

Illustration avec une usine

Note : L'explication de cette image se trouve sur notre fiche présentant une vue d'ensemble de l'environnement web.

Les éléments suivants de l'usine sont mis en surveillance : bâtiment ressemblant à un entrepôt.

Dans cet exemple

Les navigateurs ne sont pas les seuls logiciels à accéder à internet. On retrouvera pêle-mêle :

  • Les jeux vidéo nécessitant une connexion internet (gacha, connexion PSN, …)
  • Les applications mobiles nécessitant une connexion internet (9gag, VDM, Le Figaro…)
  • Les logiciels sur notre ordinateur nécessitant une connexion internet (Outlook…)

Notes complémentaires

  • Ce schéma est simplifié.
  • La base de données, le framework et les fondations (voir nos fiches dédiées) ne sont pas spécifiques à l’environnement web serveur.

Un logiciel ou une application qui n’est pas un navigateur n’a rien à faire du style des pages (CSS) ou du JavaScript. Souvent, il préférera une autre structure et un autre contenu (HTML).
Ce type de logiciel veut uniquement les données brutes, au format le plus succinct possible (JSON ou XML).

Comparer un site web pour humain et une API

Exemple de site web

Un site web très basique avec trois pages naviguables dans un menu en haut de la page (accueil, prestations, contact).
Dans la page actuelle, un titre "Bienvenue sur ce site web d'exemple", un paragraphe "Un paragraphe d'exemple pour expliquer le but du site", et une liste à puces "Prestations référencées" contenant les items suivants : "Audit et conseil", "Formation" et "Graphisme et accessibilité".

Exemple d'API

                    
                        {
                            "navigation": [
                                { "titre": "Page d'accueil", "page": "https://ls-a.fr/" },
                                { "titre": "Page de prestations", "page": "https://ls-a.fr/prestations" },
                                { "titre": "Page de contact", "page": "https://ls-a.fr/contact" }
                            ],
                            "titre": "Bienvenue sur ce site web d'exemple",
                            "sous-titre": "Un paragraphe d'exemple pour expliquer le but du site",
                            "prestations": "Prestations référencées",
                            "liste-prestations": [
                                "Audit et Conseil",
                                "Formation",
                                "Graphisme et accessibilité"
                            ]
                        }
                    
                

Navigation rapide