Développeurs et assistants IA
Precellence pour les agents et assistants IA
Un agent ou un assistant IA peut demander nos prix TTC par véhicule avec GET /api/public/quote, lire nos conditions avec GET /api/public/conditions, puis envoyer le voyageur sur un lien de réservation pré-rempli. Lecture seule, sans clé ni compte, sans donnée personnelle, limitée à 30 unités par heure et par adresse IP. La réservation et le paiement se font toujours sur notre site.
Adresses publiques
| Méthode | Adresse | Rôle | Cache |
|---|---|---|---|
| GET | /api/public/quote | Prix TTC par classe, raison claire si « sur devis », lien de réservation | 10 min |
| GET | /api/public/conditions | Classes, zones à prix fixe, taux horaires, options, attente, annulation, délai, contacts | 1 h |
| GET | /openapi.json | Description OpenAPI 3.1 (schémas, exemples, limites) | — |
| GET | /llms.txt | Présentation du site pour les assistants IA | — |
Paramètres (identiques au lien de réservation)
| Paramètre | Format | Exemple |
|---|---|---|
from | Départ en texte : numéro et rue, hôtel, gare, aéroport, terminal | 15 Avenue Montaigne, Paris |
to | Arrivée en texte (inutile en mise à disposition) | Aéroport CDG |
date | Date de Paris, AAAA-MM-JJ | 2026-11-20 |
time | Heure de Paris, HH:MM (9:30 ou 9h30 acceptés) | 09:30 |
pax | Passagers, 1 à 7 | 2 |
class | Classe à présélectionner : business (Mercedes Classe E), electric (Mercedes EQE), first (Mercedes Classe S), van (Mercedes V-Class), ev (Mercedes EQV) | first |
lang | Langue des messages et du lien : fr, en, ar | fr |
type | oneway (transfert, par défaut) ou hourly (mise à disposition) | hourly |
duration | Heures, 3 à 12, avec type=hourly | 4 |
Lien de réservation pré-rempli
https://precellence-service.com/reservation?from={from}&to={to}&date={YYYY-MM-DD}&time={HH:MM}&pax={1-7}&class={business|electric|first|van|ev}&lang={fr|en|ar}
https://precellence-service.com/reservation?type=hourly&duration={3-12}&from={address}&date={YYYY-MM-DD}&time={HH:MM}&lang={fr|en|ar}
Ouvre le formulaire de réservation avec le trajet rempli et la classe choisie ; le prix est redemandé au serveur. Rien n'est enregistré avant que le voyageur clique sur « Continuer ».
Règles et limites
- Limite : 30 unités par heure et 200 par jour par adresse IP ; une demande calculée coûte 1 unité, plus 1 si Google doit situer les adresses et 1 s'il doit calculer l'itinéraire (les lieux et itinéraires déjà connus sont gardés en mémoire). Au-delà : réponse 429 et en-tête Retry-After.
- Même demande = même réponse pendant 10 minutes (gratuite) ; conditions en cache 1 h.
- CORS ouvert en lecture (GET) ; aucune clé, aucun cookie, rien n'est enregistré ; le journal ne garde ni l'adresse ni l'adresse IP.
- Adresse trop vague, départ dans moins de 2 h, véhicule de prestige, destination non publiée : réponse « on_request » avec une raison en clair (code + message) et nos contacts.
- Le paiement ne passe jamais par l'assistant : le voyageur réserve et paie sur le site, où le prix est recalculé à l'identique et garanti 20 minutes.
Exemples
curl "https://precellence-service.com/api/public/quote?from=15+Avenue+Montaigne%2C+Paris&to=A%C3%A9roport+CDG&date=2026-11-20&time=09%3A30&pax=2&class=first&lang=en"
curl "https://precellence-service.com/api/public/conditions?lang=fr"
https://precellence-service.com/reservation?from=15+Avenue+Montaigne%2C+Paris&to=A%C3%A9roport+CDG&date=2026-11-20&time=09%3A30&pax=2&class=first&lang=fr
Pour aller plus loin
- OpenAPI 3.1 (openapi.json)
- llms.txt
- Contact technique et partenariats : [email protected]