API REST — Montant en lettres | Malgache · Français · Anglais
# MONENLET API 🌍
> API REST — Montant en lettres | Malgache · Français · Anglais
API REST open source pour convertir un montant numérique en lettres,
utilisable depuis n'importe quel langage, framework ou application tierce.
---
## Démo rapide
```bash
# Malgache
curl "
api.example.com"
# Français
curl -X POST
api.example.com \
-H "Content-Type: application/json" \
-d '{"amount": 1250.25, "lang": "fr"}'
# Anglais
curl "
api.example.com"
```
---
## Endpoints
| Méthode | Route | Description |
|---|---|---|
| `GET` | `/` | Informations et liste des endpoints |
| `GET` | `/health` | Health check (uptime, version) |
| `POST` | `/convert` | Conversion via body JSON |
| `GET` | `/convert?amount=&lang=` | Conversion via query params |
| `GET` | `/convert/langs` | Liste des langues supportées |
| `GET` | `/docs` | Documentation Swagger UI interactive |
| `GET` | `/docs/json` | Spec OpenAPI 3.0 en JSON brut |
---
## Syntaxe
### POST /convert
```json
{
"amount": 1352689.60,
"lang": "mg",
"currency": "Ariary",
"decimals": 2
}
```
| Paramètre | Type | Requis | Défaut | Description |
|---|---|---|---|---|
| `amount` | number | ✅ | — | Montant (max 999 999 999 999) |
| `lang` | `mg` \| `fr` \| `en` | ✅ | — | Langue de conversion |
| `currency` | string | ❌ | `Ariary` / `ARIARY` | Libellé de devise |
| `decimals` | 0 \| 1 \| 2 | ❌ | `2` | Précision décimale |
### Réponse
```json
{
"success": true,
"data": {
"amount": 1352689.60,
"lang": "mg",
"lang_label": "Malgache",
"currency": "Ariary",
"decimals": 2,
"result": "Sivy amby valopolo sy eninjato sy roa arivo sy dimy alina sy telo hetsy sy iray tapitrisa Ariary faingo enimpolo",
"input_formatted": "1 352 689,60"
},
"meta": {
"version": "1.0.0",
"supported_langs": ["mg", "fr", "en"]
}
}
```
### GET /convert (query params)
```
GET /convert?amount=125 …