Créer une API REST Rust avec Axum et SQLite
Exemple testé le avec Miblo 0.9.1 · NaSuRall
Créer une API REST avec Rust, Axum et SQLite : générer un modèle User, ses routes CRUD et tester une requête POST avec Miblo.
▶ Voir la démoDans cette page
Avant de commencer
Ce tutoriel crée une API locale avec une table users, cinq routes CRUD et une base SQLite. Miblo CLI génère les sources Axum et SQLx ; vous pouvez ensuite les modifier librement.
Il vous faut Rust 1.88 ou ultérieur, Cargo, rustfmt et les outils de compilation de votre système. Préparer votre environnement → Aucun serveur SQL ni Docker n’est nécessaire pour SQLite. Une connexion Internet est nécessaire au premier téléchargement des templates et des dépendances Rust.
rustup component add rustfmt
cargo install miblo --version 0.9.1 --locked
miblo --versionLa génération est rapide ; l’installation et la première compilation Rust peuvent prendre plusieurs minutes. Utilisez un dossier neuf et un port 3000 disponible.
1. Créer le projet
mibloCes étapes suivent les menus français : choisissez Français avec Maj+L, puis Entrée.
- Appuyez sur n et saisissez
team-api. - Validez un dossier qui n’existe pas encore, puis le port
3000. - Choisissez SQLite — fichier local, configuration automatique.
- Choisissez GitHub Releases, puis Créer le projet.
Le projet et le fichier miblo.sqlite sont créés. L’état BDD affiche Migrations à jour.
2. Ajouter User
- Appuyez sur a et saisissez
User. - Ajoutez
name, type Texte court, sans option. - Choisissez Ajouter un autre champ :
email, type Texte court. Cochez Unique avec Espace. - Choisissez Terminer et générer, validez
/users, puis Générer.
Miblo crée la table users avec sa clé id, le code Rust et les cinq routes CRUD. L’API étant arrêtée, la migration SQLite est appliquée automatiquement.
3. Envoyer un POST
- Appuyez sur r et attendez API en cours.
- Passez au panneau Routes avec Tab, sélectionnez
POST /users, puis x. - Les champs sont déjà remplis. Entrée permet de modifier une valeur.
- Sélectionnez Envoyer la requête puis Entrée. La réponse est HTTP 201.
- Testez
GET /userspour retrouver la ligne créée.
s arrête l’API. La première compilation prend plus de temps que les lancements suivants.
Le même parcours dans le shell
miblo new team-api --database sqlite --yes
cd team-api
miblo add User name:string email:string:unique --yes
miblo db init
miblo runOuvrez ensuite miblo dans un second terminal, depuis team-api, pour tester les routes. L’API lancée ailleurs est signalée comme externe.
Les routes et la réponse obtenues
| Méthode | Route | Résultat |
|---|---|---|
| POST | /users | Crée un utilisateur : HTTP 201 et son JSON. |
| GET | /users | Liste paginée : HTTP 200 et un tableau JSON. |
| GET | /users/{id} | Lit un utilisateur : HTTP 200, ou 404 si absent. |
| PATCH | /users/{id} | Modifie les champs envoyés : HTTP 200. |
| DELETE | /users/{id} | Supprime un utilisateur : HTTP 204, sans corps. |
Dans un second terminal, cette commande crée Alice. Les exemples shell utilisent la syntaxe de macOS, Linux ou Git Bash ; depuis PowerShell, vous pouvez utiliser le formulaire intégré à Miblo.
curl -i http://127.0.0.1:3000/users \
-H 'Content-Type: application/json' \
-d '{"name":"Alice","email":"alice@example.com"}'Sur une base neuve, le premier utilisateur reçoit l’identifiant 1. Réponse HTTP 201 :
{"id":1,"name":"Alice","email":"alice@example.com"}curl http://127.0.0.1:3000/users
curl http://127.0.0.1:3000/users/1Remplacez 1 par l’identifiant reçu si votre base contient déjà des lignes. Un deuxième POST avec le même e-mail renvoie 409, car le champ est unique. L’API reste en cours dans le premier terminal ; Ctrl+C l’arrête.
Où modifier le code généré
team-api/
├── Cargo.toml
├── .env
├── miblo.yaml
├── miblo.sqlite
├── migrations/
└── src/
├── main.rs
├── database.rs
└── resources/user/
├── mod.rs
├── model.rs
├── requests.rs
├── handlers.rs
├── service.rs
└── repository.rshandlers.rs traite HTTP, service.rs reçoit vos règles métier et repository.rs contient les requêtes SQL. requests.rs décrit les données reçues. Voir toute l’architecture →
Pour démarrer avec MySQL, utilisez --database mysql dans un nouveau projet et configurez un serveur existant : configuration MySQL. Cela ne convertit pas une base SQLite existante.
Suite du projet
Continuez avec l’exemple User et Group : clé étrangère et route personnalisée.
m pour ajouter un champ, g pour créer une route, d pour voir le schéma et e pour ouvrir le code.