يقدم LeyApp واجهة برمجة تطبيقات عامة للتحقق من توفر المحامين وبدء حجوزات الاستشارات. مصممة لمساعدي الذكاء الاصطناعي والتكاملات وأدوات الطرف الثالث.
سجّل للحصول على وصول مبكر لمفاتيح API وحدود معدل أعلى ونقاط نهاية جديدة عند إطلاقها.
سنخطر المطورين عندما تصبح مفاتيح API متاحة.
/api/v1/lawyers/{lawyer_id}/availabilityيُرجع المواعيد المتاحة للاستشارة لمحامٍ محدد. لا يتطلب مصادقة. نطاق التواريخ محدود بـ 14 يوماً.
| المعلمة | النوع | مطلوب | الوصف |
|---|---|---|---|
| start_date | YYYY-MM-DD | لا | بداية نطاق التاريخ (الافتراضي: اليوم) |
| end_date | YYYY-MM-DD | لا | نهاية نطاق التاريخ (الافتراضي: اليوم + 13 يوماً) |
{
"lawyer_id": "a1b2c3d4-...",
"lawyer_name": "Ana García López",
"hourly_rate_cents": 12000,
"currency": "EUR",
"booking_fee_cents": 200,
"slots": [
{
"date": "2026-03-02",
"start_time": "09:00:00",
"end_time": "10:00:00",
"available": true
}
],
"booking_url": "https://leyapp.es/lawyer/a1b2c3d4#book",
"profile_url": "https://leyapp.es/lawyer/a1b2c3d4"
}/api/v1/bookings/initiateيُنشئ نية حجز ويُرجع رابط تأكيد. يجب على المستخدم زيارة هذا الرابط للمصادقة وإكمال الدفع. لا يمكن إتمام الحجوزات عبر واجهة البرمجة وحدها.
POST /api/v1/bookings/initiate
Content-Type: application/json
{
"lawyer_id": "a1b2c3d4-...",
"date": "2026-03-02",
"start_time": "09:00:00",
"end_time": "10:00:00",
"source": "ai_agent",
"agent_name": "ChatGPT"
}{
"booking_intent_id": "intent_xyz789",
"confirmation_url": "https://leyapp.es/book/confirm?intent=intent_xyz789",
"expires_at": "2026-03-02T08:00:00Z",
"slot": { "date": "2026-03-02", "start_time": "09:00:00", "end_time": "10:00:00" },
"lawyer": { "id": "a1b2c3d4-...", "name": "Ana García López", "hourly_rate_cents": 12000 },
"message": "To confirm this booking, the user must visit the confirmation URL."
}مصادقة المستخدم مطلوبة دائماً
يجب على مساعدي الذكاء الاصطناعي تقديم رابط التأكيد للمستخدم. يجب على المستخدم دائماً تسجيل الدخول وتأكيد الدفع في LeyApp.
حدود المعدل
التوفر: 10 طلبات/دقيقة لكل IP. بدء الحجز: 5 طلبات/ساعة لكل IP.
تنتهي النوايا خلال 15 دقيقة
تنتهي صلاحية روابط تأكيد الحجز بعد 15 دقيقة. تحقق دائماً من التوفر قبل إنشاء نية جديدة.
الأسعار بسنتات اليورو
جميع المبالغ بالسنتات (مثال: 12000 = 120.00 يورو). العملة دائماً EUR.
مفاتيح API والمصادقة
تسجيل المطورين مع مفاتيح API لحدود معدل أعلى وتتبع الاستخدام.
نقطة نهاية البحث عن المحامين
ابحث عن محامين حسب التخصص والمدينة واللغة ونطاق الأسعار عبر واجهة البرمجة.
إشعارات Webhooks
استلم إشعارات فورية عند تأكيد الحجوزات أو إلغائها أو تعديلها.
مصادقة OAuth 2.1
تدفق OAuth مفوض لشركاء الذكاء الاصطناعي الموثوقين لإتمام الحجوزات نيابة عن المستخدمين.
هل تحتاج المزيد من المعلومات أو تريد دمج واجهة برمجة تطبيقات LeyApp؟