المطوّرون والمساعدون الذكيون
Precellence للوكلاء والمساعدين الذكيين
يستطيع الوكيل أو المساعد الذكي الحصول على أسعارنا شاملة الضريبة لكل سيارة عبر GET /api/public/quote، وقراءة شروطنا عبر GET /api/public/conditions، ثم توجيه المسافر إلى رابط حجز مُعبّأ مسبقًا. قراءة فقط، دون مفتاح أو حساب، ودون بيانات شخصية، وبحدّ 30 وحدة في الساعة لكل عنوان IP. الحجز والدفع يتمّان دائمًا على موقعنا.
العناوين العامة
| الطريقة | العنوان | الدور | التخزين المؤقت |
|---|---|---|---|
| GET | /api/public/quote | أسعار شاملة الضريبة لكل فئة، سبب واضح عند عرض السعر، رابط الحجز | 10 دقيقة |
| GET | /api/public/conditions | الفئات، المناطق بسعر ثابت، الأسعار بالساعة، الخيارات، الانتظار، الإلغاء، المهلة، جهات الاتصال | 1 ساعة |
| GET | /openapi.json | وصف OpenAPI 3.1 (المخططات، الأمثلة، الحدود) | — |
| GET | /llms.txt | تعريف بالموقع للمساعدين الذكيين | — |
المعاملات (نفسها في رابط الحجز)
| المعامل | الصيغة | مثال |
|---|---|---|
from | نقطة الانطلاق نصًا: الرقم والشارع، فندق، محطة، مطار، مبنى ركاب | 15 Avenue Montaigne, Paris |
to | الوجهة نصًا (غير لازمة في الخدمة بالساعة) | Aéroport CDG |
date | تاريخ باريس، YYYY-MM-DD | 2026-11-20 |
time | توقيت باريس، HH:MM (يُقبل 9:30 أو 9h30) | 09:30 |
pax | عدد الركاب، من 1 إلى 7 | 2 |
class | الفئة المختارة مسبقًا : business (مرسيدس الفئة E), electric (مرسيدس EQE), first (مرسيدس الفئة S), van (مرسيدس فئة V), ev (مرسيدس EQV) | first |
lang | لغة الرسائل والرابط : fr, en, ar | ar |
type | oneway (نقل، افتراضي) أو hourly (خدمة بالساعة) | hourly |
duration | عدد الساعات، من 3 إلى 12، مع type=hourly | 4 |
رابط الحجز المُعبّأ مسبقًا
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}
يفتح نموذج الحجز مع الرحلة مُعبّأة والفئة مختارة؛ ويُطلب السعر مجددًا من الخادم. لا يُحفظ شيء قبل أن ينقر المسافر على «متابعة».
القواعد والحدود
- الحدّ: 30 وحدة في الساعة و200 في اليوم لكل عنوان IP؛ الطلب المحسوب يكلّف وحدة واحدة، مع وحدة إضافية إذا احتاج Google إلى تحديد العناوين وأخرى إذا احتاج إلى حساب المسار (الأماكن والمسارات المعروفة محفوظة). بعد ذلك: ردّ 429 مع الترويسة Retry-After.
- الطلب نفسه = الردّ نفسه لمدة 10 دقائق (مجانًا)؛ الشروط مخزّنة 1 ساعة.
- CORS مفتوح للقراءة (GET)؛ لا مفتاح ولا ملفات تعريف ارتباط ولا يُحفظ شيء؛ السجلّ لا يحتفظ بالعنوان ولا بعنوان IP.
- عنوان غير دقيق، انطلاق بعد أقل من 2 ساعة، سيارة فاخرة، وجهة غير منشورة: ردّ «on_request» مع سبب واضح (رمز + رسالة) وجهات الاتصال.
- لا يمرّ الدفع أبدًا عبر المساعد: يحجز المسافر ويدفع على الموقع، حيث يُعاد حساب السعر نفسه ويُضمن لمدة 20 دقيقة.
أمثلة
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=ar"
https://precellence-service.com/ar/reservation?from=15+Avenue+Montaigne%2C+Paris&to=A%C3%A9roport+CDG&date=2026-11-20&time=09%3A30&pax=2&class=first&lang=ar
للمزيد
- OpenAPI 3.1 (openapi.json)
- llms.txt
- التواصل التقني والشراكات : [email protected]