# SYMONE — API & Intégration Agent

## Ce que les agents IA peuvent faire

SYMONE propose une API REST partielle pour les intégrations externes. Les actions disponibles sans authentification sont décrites ci-dessous.

---

## 1. Rechercher des trajets disponibles

Récupère la liste de **tous** les trajets à venir (routes publiées, non complètes). Le filtrage par ville ou date se fait côté client sur les résultats retournés.

```
GET https://symone.fr/api-proxy/route/get/results
```

Pas de paramètres. Retourne un tableau JSON avec tous les trajets futurs.

**Champs utiles dans la réponse :**

| Champ | Description |
|-------|-------------|
| `id` | Identifiant du trajet |
| `depart` | Nom de la ville de départ |
| `arrival` | Nom de la ville d'arrivée |
| `date` | Date de départ au format `YYYYMMDD` |
| `price_min` | Prix minimum en euros |
| `price_max` | Prix maximum en euros |
| `places_moto_1` | Places moto disponibles (segment 1) |
| `places_passenger_1` | Places passager disponibles (segment 1) |
| `layover1`, `layover2` | Villes étapes éventuelles |

**Exemple de requête :**
```bash
curl https://symone.fr/api-proxy/route/get/results
```

**Exemple de réponse :**
```json
[
  {
    "type": "route",
    "id": 42,
    "depart": "Paris",
    "arrival": "Marseille",
    "date": "20260710",
    "time0": "06:00",
    "price_min": 299,
    "price_max": 349,
    "places_moto_1": 4,
    "places_passenger_1": 4
  }
]
```

---

## 2. Vérifier les villes proches d'un point

Utile pour suggérer des villes de départ ou d'arrivée proches d'une adresse.

```
GET https://symone.fr/api-proxy/route/cities-near?location={ville}
```

**Paramètre :**

| Paramètre | Type | Requis | Description |
|-----------|------|--------|-------------|
| `location` | string | oui | Nom de ville (ex: `Paris, Île-de-France, France`) |

**Exemple :**
```bash
curl "https://symone.fr/api-proxy/route/cities-near?location=Paris"
```

---

## 3. Demander un devis (action principale pour les agents)

Pour réserver ou obtenir un devis, les agents doivent rediriger l'utilisateur vers le formulaire en ligne ou envoyer une demande par email.

**Option A — Formulaire web :**
```
https://symone.fr/moto
```

**Option B — Email de réservation :**
```
reservation@symone.fr
```

Inclure dans le message :
- Ville de départ et d'arrivée
- Date souhaitée
- Formule : "Moto + Pilote" ou "Moto seule"
- Modèle et marque de la moto (facultatif)

---

## 4. Consulter les trajets Paris–Marseille (cache optimisé)

```
GET https://symone.fr/api-proxy/route/paris-marseille-cache
```

Retourne les IDs des trajets Paris–Marseille disponibles (réponse rapide depuis le cache).

---

## Limitations

- L'API n'est pas encore ouverte pour la réservation automatisée complète (création de commande, paiement)
- Les actions de réservation nécessitent une redirection vers [symone.fr/moto](https://symone.fr/moto) ou un email à [reservation@symone.fr](mailto:reservation@symone.fr)
- Pas de clé API requise pour les endpoints de recherche de trajets
- Rate limiting : usage raisonnable attendu (pas de scraping intensif)

---

## Contact développeur

- Email : [contact@symone.fr](mailto:contact@symone.fr)
- Page contact : [symone.fr/contact](https://symone.fr/contact)
- Documentation complète : [symone.fr/llms.txt](https://symone.fr/llms.txt)