From 1ff364e4a846c7acf740524f7a6df74588506c4d Mon Sep 17 00:00:00 2001
From: imperosol <thgirod@hotmail.com>
Date: Tue, 20 May 2025 18:18:36 +0200
Subject: [PATCH] add doc for external API consumers

---
 docs/img/api_key_authorize_1.png | Bin 0 -> 33518 bytes
 docs/img/api_key_authorize_2.png | Bin 0 -> 50366 bytes
 docs/tutorial/connect-api.md     | 215 +++++++++++++++++++++++++++++++
 mkdocs.yml                       |   3 +-
 4 files changed, 217 insertions(+), 1 deletion(-)
 create mode 100644 docs/img/api_key_authorize_1.png
 create mode 100644 docs/img/api_key_authorize_2.png
 create mode 100644 docs/tutorial/connect-api.md

diff --git a/docs/img/api_key_authorize_1.png b/docs/img/api_key_authorize_1.png
new file mode 100644
index 0000000000000000000000000000000000000000..b01d2e6674f75193c35b99c61ea6ab60def163d5
GIT binary patch
literal 33518
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
Z?)mV0@b`xqcYj$jWh52fmx~+v{~r)u^X32m

literal 0
HcmV?d00001

diff --git a/docs/img/api_key_authorize_2.png b/docs/img/api_key_authorize_2.png
new file mode 100644
index 0000000000000000000000000000000000000000..9d562328ed2e95eda02ae5d3830e3d4d8db26862
GIT binary patch
literal 50366
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
YU6Lu?`?o7*-VH)lN=Y*3fq~Ee0Qv+csQ>@~

literal 0
HcmV?d00001

diff --git a/docs/tutorial/connect-api.md b/docs/tutorial/connect-api.md
new file mode 100644
index 00000000..72c01a85
--- /dev/null
+++ b/docs/tutorial/connect-api.md
@@ -0,0 +1,215 @@
+La connexion à l'API du site AE peut se faire par deux moyens :
+
+- par le cookie de session du site ; si vous accédez à l'API depuis le sith
+  en étant connecté, cette méthode fonctionne par défaut
+- par clef d'API ; si vous accédez à l'API depuis une application externe,
+  vous devez passer par cette méthode.
+
+Comme la méthode par cookie de session ne devrait pas être utilisée
+en dehors du cadre interne au site et qu'elle marche par défaut
+dans le cadre de ce dernier, nous ne décrirons pas outre mesure la manière
+de l'utiliser.
+
+## Obtenir une clef d'API
+
+Il n'y a, à l'heure actuelle, pas d'interface accessible sur le site
+pour obtenir une clef d'API.
+Si vous désirez en obtenir une, demandez directement au respo info.
+
+!!!danger
+
+    Votre clef d'API doit rester secrète.
+    Ne la transmettez à personne, ne l'inscrivez pas en dur dans votre code.
+
+    Si votre clef a fuité, ou que vous soupçonnez qu'elle ait pu fuiter,
+    informez-en immédiatement l'équipe informatique !
+
+## L'interface Swagger
+
+Avant de commencer à utiliser l'API du site, vous pouvez explorer
+les différentes routes qu'elle met à disposition, 
+avec les schémas de données attendus en requête et en réponse.
+
+Pour cela, vous pouvez vous rendre sur
+[https://ae.utbm.fr/api/docs](https://ae.utbm.fr/api/docs).
+
+Toutes les routes, à de rares exceptions près, y sont recensées.
+Vous pouvez les utiliser dans les limites 
+de ce à quoi vos permissions vous donnent droit
+et de la méthode d'authentification.
+
+Vous pouvez vous connecter directement sur l'interface Swagger,
+en cliquant sur ce bouton, en haut à droite :
+
+![Swagger auth (1)](../img/api_key_authorize_1.png)
+/// caption
+Bouton d'autorisation sur Swagger
+///
+
+Puis rentrez votre clef d'API dans le champ prévu à cet effet,
+et cliquez sur authorize :
+
+
+![Swagger auth (2)](../img/api_key_authorize_2.png)
+/// caption
+Saisie de la clef d'API
+///
+
+Les routes accessibles avec une clef d'API seront alors marquées par 
+une icône de cadenas fermé, sur la droite.
+
+!!!warning "Authentification et permissions"
+
+    L'icône de cadenas signifie que la route accepte l'authentification
+    basée sur les clefs d'API, mais pas forcément que vous avez les 
+    permissions nécessaires.
+    
+    Si une route vous renvoie une erreur 403, 
+    référez-en à l'équipe info, pour qu'elle puisse vous donner
+    les permissions nécessaires.
+
+## Utiliser la clef d'API
+
+### `X-APIKey`
+
+Maintenant que vous avez la clef d'API,
+il faut l'utiliser pour authentifier votre application
+lorsqu'elle effectue des requêtes au site.
+
+Pour cela, vous devez le fournir dans vos requêtes
+à travers le header `X-APIKey`.
+
+Par exemple :
+
+```shell
+curl "https://ae.utbm.fr/api/club/1" \
+  -H "X-APIKey: <votre clef d'API>"
+```
+
+Comme votre clef d'API doit rester absolument secrète,
+vous ne devez en aucun cas la mettre dans votre code.
+À la place, vous pouvez créer un fichier (par exemple, un `.env`)
+qui contiendra votre clef et qui sera gitignoré.
+
+```dotenv title=".env"
+API_KEY="<votre clef d'API>"
+```
+
+Vous fournirez alors la clef d'API en la chargeant depuis votre environnement.
+Notez que c'est une bonne pratique à double-titre,
+puisque vous pouvez ainsi aisément changer votre clef d'API.
+
+### Connexion persistante
+
+La plupart des librairies permettant d'effectuer des requêtes
+HTTP incluent une prise en charge des sessions persistantes.
+Nous vous recommandons fortement d'utiliser ces fonctionnalités,
+puisqu'elles permettent de rendre votre code plus simple
+(vous n'aurez à renseigner votre clef d'API qu'une seule fois)
+et plus efficace (réutiliser la même connexion plutôt que d'en créer
+une nouvelle à chaque requête peut résulter en un gain de performance significatif ; 
+cf. [HTTP persistant connection (wikipedia)](https://en.wikipedia.org/wiki/HTTP_persistent_connection))
+
+Voici quelques exemples : 
+
+=== "Python (requests)"
+
+    Dépendances :
+
+    - `requests` (>=2.32)
+    - `environs` (>=14.1)
+
+    ```python
+    import requests
+    from environs import Env
+
+    env = Env()
+    env.read_env()
+
+    with requests.Session() as session:
+        session.headers["X-APIKey"] = env.str("API_KEY")
+        response = session.get("https://ae.utbm.fr/api/club/1")
+        print(response.json())
+    ```
+
+=== "Python (aiohttp)"
+
+    Dépendances :
+
+    - `aiohttp` (>=3.11)
+    - `environs` (>=14.1)
+
+    ```python
+    import aiohttp
+    import asyncio
+    from environs import Env
+
+    env = Env()
+    env.read_env()
+
+    async def main():
+        async with aiohttp.ClientSession(
+            base_url="https://ae.utbm.fr/api/",
+            headers={"X-APIKey": env.str("API_KEY")}
+        ) as session:
+            async with session.get("club/1") as res:
+                print(await res.json())
+
+    asyncio.run(main())
+    ```
+
+=== "Javascript (axios)"
+
+    Dépendances :
+
+    - `axios` (>=1.9)
+    - `dotenv` (>=16.5)
+
+    ```javascript
+    import { axios } from "axios";
+    import { config } from "dotenv";
+
+    config();
+
+    const instance = axios.create({
+        baseUrl: "https://ae.utbm.fr/api/",
+        headers: { "X-APIKey": process.env.API_KEY }
+    });
+    console.log(await instance.get("club/1").json());
+    ```
+
+=== "Rust (reqwest)"
+
+    Dépendances :
+    
+    - `reqwest` (>= 0.12, features `json` et `gzip`)
+    - `tokio` (>= 1.44, feature `derive`)
+    - `dotenvy` (>= 0.15)
+
+    ```rust
+    use reqwest::Client;
+    use reqwest::header::{HeaderMap, HeaderValue};
+    use dotenvy::EnvLoader;
+
+
+    #[tokio::main]
+    async fn main() -> Result<(), Box<dyn std::error::Error>> {
+        let env = EnvLoader::new().load()?;
+        let mut headers = HeaderMap::new();
+        let mut api_key = HeaderValue::from_str(env.var("API_KEY")?.as_str());
+        api_key.set_sensitive(true);
+        headers.insert("X-APIKey", api_key);
+        let client = Client::builder()
+            .default_headers(headers)
+            .gzip(true)
+            .build()?;
+        let resp = client
+            .get("https://ae.utbm.fr/api/club/1")
+            .send()
+            .await?
+            .json()
+            .await?;
+        println!("{resp:#?}");
+        Ok(())
+    }
+    ```
diff --git a/mkdocs.yml b/mkdocs.yml
index 7201fd9d..7ad3da91 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -45,7 +45,6 @@ plugins:
             members: true
             members_order: source
             show_source: true
-            show_inherited_members: true
             merge_init_into_class: true
             show_root_toc_entry: false
   - include-markdown:
@@ -67,6 +66,7 @@ nav:
     - Gestion des permissions: tutorial/perms.md
     - Gestion des groupes: tutorial/groups.md
     - Les fragments: tutorial/fragments.md
+    - Connexion à l'API: tutorial/connect-api.md
     - Etransactions: tutorial/etransaction.md
   - How-to:
     - L'ORM de Django: howto/querysets.md
@@ -157,6 +157,7 @@ markdown_extensions:
   - pymdownx.details
   - pymdownx.inlinehilite
   - pymdownx.keys
+  - pymdownx.blocks.caption
   - pymdownx.superfences:
       custom_fences:
         - name: mermaid