Aller au contenu

Modularité : API⚓︎

Insérer programme

1. API⚓︎

1.1 Définition⚓︎

Définition

On appelle API (Application Programming Interface) une interface (ensemble de fonctions, de protocoles, de routes...) rendant disponible des fonctionnalités à d'autres programmes.

Documentation

Les API sont fournies avec une documentation expliquant comment utiliser l'interface.

Comparaison

  • UI (User Interface) : interface entre un programme et un utilisateur.
  • API (Application Programming Interface) : interface entre un programme et un autre programme.

1.2 Objectifs⚓︎

Objectifs

L'objectif est de founir un certain nombre de fonctionnalités et de les rendre utilisables à d'autre acteurs dans des conditions maitrisées et sans fournir "le code".

Cela permet de renforcer:

  • L'innovation : il est plus simple pour les développeurs de créer de nouvelles applications en utilisant les fonctionnalités et les données existantes disponibles par les API.
  • La maintenabilité : le code d'une API peut changer sans que les interfaces soient modifiées. Ainsi les applications utilisant cette API ne sont pas impactés.
  • L'efficacité : les API permettent de créer des applications sans repartir de zéro. On peut alors utiliser un grand nombre de fonctionnalités existantes.

2. Différents types d'API⚓︎

2.1 Modules python⚓︎

Les modules python peuvent être considérés comme des API.

Différents modules et leur documentation

module documentation
random https://docs.python.org/fr/3/library/random.html
flask https://flask.palletsprojects.com/en/3.0.x/api/
davistk https://davistk.brunache.ovh/
numpy https://numpy.org/doc/stable/reference/index.html#reference
pygame https://www.pygame.org/docs/genindex.html
csv https://docs.python.org/fr/3/library/csv.html
matplotlib https://matplotlib.org/stable/api/index
pandas https://pandas.pydata.org/docs/reference/index.html
tensorflow https://www.tensorflow.org/api_docs/python/tf/all_symbols

Exemples d'import de modules et d'utilisation

Il y a plusieurs moyens d'importer un module:

  • importer l'ensemble des fonctions et variables d'un module : 
    from random import *
print(randint(2, 10)) # affiche 4

  • importer une unique fonction ou variable d'un module : 

    from random import randint
print(randint(2, 10)) # affiche 4
print(choice([1, 2, 3])) # erreur choice n'a pas été importé dans l'espace de noms

  • importer l'espace de nom du module : 

    ...

On peut aussi créer ses propres modules python.

2.2 Web⚓︎

2.3 Autres⚓︎