{
    "openapi": "3.0.1",
    "info": {
        "title": "Conversion d’unités",
        "version": "1.0",
        "description": "Service REST de démonstration KoakDesign : convertit des longueurs, masses, températures et tailles de données."
    },
    "servers": [
        {
            "url": "https://www.koakdesign.info/ws_demo/conversion.php"
        }
    ],
    "tags": [
        {
            "name": "Conversion",
            "description": "Lecture seule, sans authentification"
        }
    ],
    "paths": {
        "/unites": {
            "get": {
                "tags": [
                    "Conversion"
                ],
                "summary": "Liste des unités par catégorie",
                "responses": {
                    "200": {
                        "description": "Les unités",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Unites"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/convertir": {
            "get": {
                "tags": [
                    "Conversion"
                ],
                "summary": "Convertir une valeur",
                "description": "Les deux unités doivent être de la même catégorie (ex. km vers mi, C vers F).",
                "parameters": [
                    {
                        "name": "valeur",
                        "in": "query",
                        "required": true,
                        "description": "Nombre à convertir",
                        "schema": {
                            "type": "number",
                            "example": 10
                        }
                    },
                    {
                        "name": "de",
                        "in": "query",
                        "required": true,
                        "description": "Unité de départ",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "mm",
                                "cm",
                                "m",
                                "km",
                                "in",
                                "ft",
                                "mi",
                                "g",
                                "kg",
                                "t",
                                "oz",
                                "lb",
                                "C",
                                "F",
                                "K",
                                "o",
                                "Ko",
                                "Mo",
                                "Go",
                                "To"
                            ],
                            "example": "km"
                        }
                    },
                    {
                        "name": "vers",
                        "in": "query",
                        "required": true,
                        "description": "Unité d’arrivée",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "mm",
                                "cm",
                                "m",
                                "km",
                                "in",
                                "ft",
                                "mi",
                                "g",
                                "kg",
                                "t",
                                "oz",
                                "lb",
                                "C",
                                "F",
                                "K",
                                "o",
                                "Ko",
                                "Mo",
                                "Go",
                                "To"
                            ],
                            "example": "mi"
                        }
                    },
                    {
                        "name": "decimales",
                        "in": "query",
                        "description": "Chiffres après la virgule (0 à 10)",
                        "schema": {
                            "type": "integer",
                            "default": 4
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Résultat",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Resultat"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Paramètre manquant ou unités incompatibles",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Erreur"
                                }
                            }
                        }
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "Unites": {
                "type": "object",
                "properties": {
                    "longueur": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "masse": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "temperature": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "donnees": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    }
                }
            },
            "Resultat": {
                "type": "object",
                "required": [
                    "valeur",
                    "de",
                    "vers",
                    "resultat"
                ],
                "properties": {
                    "categorie": {
                        "type": "string"
                    },
                    "valeur": {
                        "type": "number"
                    },
                    "de": {
                        "type": "string"
                    },
                    "vers": {
                        "type": "string"
                    },
                    "resultat": {
                        "type": "number"
                    },
                    "texte": {
                        "type": "string",
                        "description": "Résultat lisible : « 10 km = 6.2137 mi »"
                    }
                }
            },
            "Erreur": {
                "type": "object",
                "properties": {
                    "erreur": {
                        "type": "string"
                    }
                }
            }
        }
    }
}