TürkçeTR

Geliştiriciler ve yapay zekâ asistanları

Yapay zekâ ajanları ve asistanları için Precellence

Bir yapay zekâ ajanı veya asistanı, araç başına KDV dahil fiyatlarımızı GET /api/public/quote ile alabilir, koşullarımızı GET /api/public/conditions ile okuyabilir, ardından yolcuyu önceden doldurulmuş bir rezervasyon bağlantısına yönlendirebilir. Salt okunur; anahtar veya hesap gerekmez, kişisel veri yoktur; ücretsizdir ve tüm asistanlarca ortak kullanılır (adil kullanım aşağıda). Rezervasyon ve ödeme her zaman web sitemizde yapılır.

Herkese açık adresler

YöntemAdresİşlevÖnbellek
GET/api/public/quoteSınıf başına KDV dahil fiyatlar, fiyat teklif üzerineyse açık gerekçe, rezervasyon bağlantısı10 dk
GET/api/public/conditionsSınıflar, sabit fiyatlı bölgeler, saatlik ücretler, seçenekler, bekleme, iptal, rezervasyon süresi, iletişim1 saat
GET/openapi.jsonOpenAPI 3.1 açıklaması (şemalar, örnekler, sınırlar)—
GET/llms.txtYapay zekâ asistanları için site özeti—
POST/mcpYapay zekâ asistanları için salt okunur MCP sunucusu (fiyat teklifi ve koşul araçları)10 dk

Parametreler (rezervasyon bağlantısıyla aynı)

ParametreBiçimÖrnek
fromMetin olarak alış noktası: numara ve sokak, otel, gar, havalimanı, terminal15 Avenue Montaigne, Paris
toMetin olarak varış noktası (saatlik kiralamada gerekmez)Aéroport CDG
dateParis tarihi, YYYY-MM-DD2026-11-20
timeParis saati, HH:MM (9:30 ve 9h30 kabul edilir)09:30
paxYolcu sayısı, 1 ile 7 arası2
classÖnceden seçilecek sınıf: business (Mercedes E Serisi), electric (Mercedes EQE), first (Mercedes S Serisi), van (Mercedes V Serisi), ev (Mercedes EQV)first
langMesajların ve bağlantının dili: fr, en, ar, es, tr, ru, zh (tr, ru, zh: mesajlar İngilizce; rezervasyon bağlantısı fr, en, ar, es dillerinde, diğer dillerde İngilizce)tr
typeoneway (transfer, varsayılan) veya hourly (saatlik şoförlü kiralama)hourly
durationSaat, 3 ile 12 arası, type=hourly ile4

Önceden doldurulmuş rezervasyon bağlantısı

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|es}
https://precellence-service.com/reservation?type=hourly&duration={3-12}&from={address}&date={YYYY-MM-DD}&time={HH:MM}&lang={fr|en|ar|es}

Rezervasyon formunu yolculuk doldurulmuş ve sınıf seçilmiş olarak açar; fiyat sunucudan yeniden istenir. Yolcu « Continue » düğmesine basmadan hiçbir şey kaydedilmez (form İngilizcedir).

Kurallar ve sınırlar

Adil kullanım

Otomatik fiyat teklifi (herkese açık API ve MCP sunucusu) ücretsizdir ve tüm asistanlar tarafından ortak kullanılır. Ücretsiz kalabilmesi için adres ve güzergâh hesaplamaları her ay tüm asistanlar için toplamda sınırlandırılır ve ani yoğunluklar kısıtlanır (API için IP adresi başına dakikada 60 hesaplanmış teklif, MCP sunucusunun tamamı için dakikada 30).

Aylık sınıra ulaşıldığında bile her zaman yanıtlananlar: posta kodlu bir Paris adresi (75001 ile 75020 arası, 75116) ile bir havalimanı, Paris'in büyük bir tren garı, Disneyland, La Défense veya Versailles arasındaki sabit fiyatlı yolculuklar. Tarifedeki yerler (havalimanları, garlar, varış noktaları) adlarıyla tanınır; posta kodlu Fransız adresleri Base Adresse Nationale (IGN Géoplateforme, Licence Ouverte) ile konumlandırılır.

Aylık sınıra ulaşıldığında: hata değil, normal bir yanıt; durum « quota_reached », anlaşılır bir cümle, önceden doldurulmuş rezervasyon bağlantısı (booking_url) ve yolculuğun sabit fiyatı varsa bu fiyat. Ani yoğunlukta: HTTP 429 (API) veya JSON-RPC hatası -31429 (MCP), bekleme süresi (Retry-After) ve aynı bağlantı.

Ne yapmalı: otel adı yerine posta koduyla birlikte tam posta adresini verin (örneğin « 15 avenue Montaigne, 75008 Paris »), ardından yolcuyu booking_url bağlantısına yönlendirin: site kesin fiyatı hemen hesaplar. Bir engelleme asla bir arıza değildir: site ve rezervasyon bağlantısı her zaman çalışır.

Örnekler

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=tr"
https://precellence-service.com/en/reservation?from=15+Avenue+Montaigne%2C+Paris&to=A%C3%A9roport+CDG&date=2026-11-20&time=09%3A30&pax=2&class=first&lang=en

Tam yanıt örneği (GET /api/public/quote)

{
  "ok": true,
  "status": "priced",
  "quote_id": "pq_0123456789abcdef",
  "currency": "EUR",
  "prices_include_vat": true,
  "lang": "en",
  "lang_requested": "en",
  "trip": {
    "type": "oneway",
    "from": "15 Avenue Montaigne, Paris",
    "to": "Aéroport CDG",
    "date": "2026-11-20",
    "time": "09:30",
    "timezone": "Europe/Paris",
    "pickup_at": "2026-11-20T08:30:00.000Z",
    "passengers": 2,
    "duration_hours": null,
    "distance_km": 32.4,
    "duration_min": 45
  },
  "selected_class": "first",
  "from_price_ttc": 115,
  "classes": [
    {
      "id": "business",
      "name": "Mercedes E-Class",
      "category": "Business",
      "passengers": "1-3",
      "passengers_max": 3,
      "luggage": "2",
      "luggage_hold": 2,
      "luggage_cabin": 2,
      "luggage_text": "2 suitcases in the boot and 2 pieces of hand luggage",
      "fits_passengers": true,
      "selected": false,
      "status": "priced",
      "price_ttc": 115,
      "price_ttc_cents": 11500,
      "price_type": "forfait",
      "reason": null,
      "booking_url": "https://precellence-service.com/en/reservation?from=15+Avenue+Montaigne%2C+Paris&to=A%C3%A9roport+CDG&date=2026-11-20&time=09%3A30&pax=2&class=business&lang=en"
    },
    {
      "id": "electric",
      "name": "Mercedes EQE",
      "category": "Electric",
      "passengers": "1-3",
      "passengers_max": 3,
      "luggage": "2",
      "luggage_hold": 2,
      "luggage_cabin": 2,
      "luggage_text": "2 suitcases in the boot and 2 pieces of hand luggage",
      "fits_passengers": true,
      "selected": false,
      "status": "priced",
      "price_ttc": 115,
      "price_ttc_cents": 11500,
      "price_type": "forfait",
      "reason": null,
      "booking_url": "https://precellence-service.com/en/reservation?from=15+Avenue+Montaigne%2C+Paris&to=A%C3%A9roport+CDG&date=2026-11-20&time=09%3A30&pax=2&class=electric&lang=en"
    },
    {
      "id": "first",
      "name": "Mercedes S-Class",
      "category": "First Class",
      "passengers": "1-3",
      "passengers_max": 3,
      "luggage": "2",
      "luggage_hold": 2,
      "luggage_cabin": 2,
      "luggage_text": "2 suitcases in the boot and 2 pieces of hand luggage",
      "fits_passengers": true,
      "selected": true,
      "status": "priced",
      "price_ttc": 240,
      "price_ttc_cents": 24000,
      "price_type": "forfait",
      "reason": null,
      "booking_url": "https://precellence-service.com/en/reservation?from=15+Avenue+Montaigne%2C+Paris&to=A%C3%A9roport+CDG&date=2026-11-20&time=09%3A30&pax=2&class=first&lang=en"
    },
    {
      "id": "van",
      "name": "Mercedes V-Class",
      "category": "Van / SUV",
      "passengers": "1-7",
      "passengers_max": 7,
      "luggage": "7",
      "luggage_hold": 7,
      "luggage_cabin": null,
      "luggage_hold_detail": {
        "large": 4,
        "medium": 2,
        "stroller_or_cabin_case": 1
      },
      "luggage_fewer_passengers": {
        "up_to_passengers": 5,
        "luggage_hold": "8-9"
      },
      "luggage_to_declare": [
        "stroller",
        "golfBag",
        "foldedBike"
      ],
      "luggage_text": "4 large suitcases in the boot + 2 medium ones + a pushchair or a cabin suitcase, plus hand luggage; with fewer passengers, more suitcases (up to 5 passengers: 8 to 9 suitcases); pushchair, golf bag, folded bike: please tell us",
      "fits_passengers": true,
      "selected": false,
      "status": "priced",
      "price_ttc": 159,
      "price_ttc_cents": 15900,
      "price_type": "forfait",
      "reason": null,
      "booking_url": "https://precellence-service.com/en/reservation?from=15+Avenue+Montaigne%2C+Paris&to=A%C3%A9roport+CDG&date=2026-11-20&time=09%3A30&pax=2&class=van&lang=en"
    },
    {
      "id": "ev",
      "name": "Mercedes EQV",
      "category": "Electric Van",
      "passengers": "1-7",
      "passengers_max": 7,
      "luggage": "4",
      "luggage_hold": 4,
      "luggage_cabin": 3,
      "luggage_text": "4 suitcases in the boot and 3 pieces of hand luggage",
      "fits_passengers": true,
      "selected": false,
      "status": "priced",
      "price_ttc": 159,
      "price_ttc_cents": 15900,
      "price_type": "forfait",
      "reason": null,
      "booking_url": "https://precellence-service.com/en/reservation?from=15+Avenue+Montaigne%2C+Paris&to=A%C3%A9roport+CDG&date=2026-11-20&time=09%3A30&pax=2&class=ev&lang=en"
    }
  ],
  "reason": null,
  "booking_url": "https://precellence-service.com/en/reservation?from=15+Avenue+Montaigne%2C+Paris&to=A%C3%A9roport+CDG&date=2026-11-20&time=09%3A30&pax=2&class=first&lang=en",
  "included": {
    "tolls": true,
    "fuel": true,
    "child_seat": true,
    "name_board": true,
    "flight_tracking": true,
    "no_surcharge_night_weekend_holiday": true,
    "free_waiting_minutes": {
      "airport": 60,
      "station": 30,
      "address": 15
    },
    "airport_waiting_counts_from": "actual_landing"
  },
  "conditions": {
    "min_lead_minutes": 120,
    "price_guaranteed_minutes_once_opened_on_site": 20,
    "payment": {
      "when": "full_amount_at_booking",
      "where": "website_only"
    },
    "details_url": "https://precellence-service.com/api/public/conditions?lang=en",
    "terms_url": "https://precellence-service.com/en/cgv"
  },
  "contact": {
    "phone": "+33158963943",
    "whatsapp": "+33769700020",
    "email": "[email protected]",
    "quote_form_url": "https://precellence-service.com/en/devis"
  },
  "notice": "Prices include VAT, per vehicle, computed by the website pricing engine. Booking and payment happen on the website only, through booking_url: the same price is recomputed there, then guaranteed for 20 min. No payment through the assistant.",
  "generated_at": "2026-10-17T10:00:00.000Z",
  "valid_until": "2026-10-17T10:20:00.000Z",
  "tariff_version": "precellence-2026-11b",
  "engine_version": "precellence-engine-1",
  "api_version": "1.0.0"
}

Yanıt ve hata biçimleri

Sonuçlarda görüldüğü şekliyle fiyat kuralları

Hizmet alanı

Sınıflar ve kapasiteler

Sınıf (id)Yolcu (en fazla)Bagajda valiz (en fazla)
Mercedes E Serisi business32
Mercedes EQE electric32
Mercedes S Serisi first32
Mercedes V Serisi van77
Mercedes EQV ev74

İptal (genel satış koşullarının 5. maddesi)

Ödeme

Diller

Süreler

Sürümler

Durum ve arızalar

Kullanım koşulları

MCP sunucusu (yapay zekâ asistanları)

Adres: https://precellence-service.com/mcp. Uzak MCP sunucusu (Model Context Protocol, « Streamable HTTP » aktarımı, durumsuz), salt okunur ve kimlik doğrulamasız: anahtar yok, hesap yok, kişisel veri yok. 2 aracı yukarıdaki API ile aynı işlevleri çağırır: aynı fiyatlar, aynı koşullar, aynı rezervasyon bağlantısı.

https://precellence-service.com/mcp

Bir asistana ekleyin

Araçlar

Araçların girdileri ve çıktıları

Her aracın okunabilir bir başlığı (title) ve readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false açıklamaları vardır: yalnızca okur, hiçbir şey yazmaz veya silmez. Her yanıt okunabilir bir metin ve aynı içeriği JSON olarak (structuredContent) içerir.

obtenir_devis — Get a quote — Precellence Service (Paris chauffeur)

Girdiler

from (zorunlu)
Metin olarak alış noktası: numara ve sokak, otel, gar, havalimanı, terminal
to (type değeri hourly değilse zorunlu)
Metin olarak varış noktası (saatlik kiralamada gerekmez)
date (zorunlu)
Paris tarihi, YYYY-MM-DD
time (zorunlu)
Paris saati, HH:MM (9:30 ve 9h30 kabul edilir)
pax (isteğe bağlı)
Yolcu sayısı, 1 ile 7 arası
class (isteğe bağlı)
Önceden seçilecek sınıf: business (Mercedes E Serisi), electric (Mercedes EQE), first (Mercedes S Serisi), van (Mercedes V Serisi), ev (Mercedes EQV)
lang (isteğe bağlı)
Mesajların ve bağlantının dili: fr, en, ar, es, tr, ru, zh (tr, ru, zh: mesajlar İngilizce; rezervasyon bağlantısı fr, en, ar, es dillerinde, diğer dillerde İngilizce)
type (isteğe bağlı)
oneway (transfer, varsayılan) veya hourly (saatlik şoförlü kiralama)
duration (type değeri hourly ise zorunlu)
Saat, 3 ile 12 arası, type=hourly ile

Çıktılar

status (priced, on_request veya quota_reached), currency, trip (sunucunun anladığı yolculuk), classes[] (id, name, passengers, luggage, status, price_ttc, price_is_estimate, exact_address_required, booking_url), fiyat verilmediğinde reason (code, message, candidates), address_estimate, booking_url, included, conditions, contact, quote_id, valid_until.

voir_conditions — Service conditions — Precellence Service

Girdiler

lang (isteğe bağlı)
Mesajların ve bağlantının dili: fr, en, ar, es, tr, ru, zh (tr, ru, zh: mesajlar İngilizce; rezervasyon bağlantısı fr, en, ar, es dillerinde, diğer dillerde İngilizce)

Çıktılar

classes (yolcular, bagaj, asgari yolculuk ücreti, saatlik ücret), fixed_price_zones, long_distance, hourly_hire, options, waiting, cancellation (iade kademeleri), booking (süre, fiyat geçerliliği, ödeme), contact, links.

Reddedilen parametre veya geçmiş tarih: isError: true ve reddedilen parametrelerin listesiyle (details) sonuç. Aynı anda çok fazla istek: retry_after_seconds ve booking_url ile JSON-RPC hatası -31429.

MCP sunucusunun sınırları

JSON-RPC örnekleri (curl)

curl -s https://precellence-service.com/mcp -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'
curl -s https://precellence-service.com/mcp -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -H "MCP-Protocol-Version: 2025-06-18" -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
curl -s https://precellence-service.com/mcp -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -H "MCP-Protocol-Version: 2025-06-18" -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"obtenir_devis","arguments":{"from":"15 Avenue Montaigne, Paris","to":"Aéroport CDG","date":"2026-11-20","time":"09:30","pax":2,"class":"first","lang":"tr"}}}'
curl -s https://precellence-service.com/mcp -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -H "MCP-Protocol-Version: 2026-07-28" -H "Mcp-Method: server/discover" -d '{"jsonrpc":"2.0","id":4,"method":"server/discover","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}}}}'

Daha fazla bilgi

Yolculuk rezervasyonu yapın →