Vezeli
Vezeli للمطوّرين ووكلاء الذكاء الاصطناعي
يتيح Vezeli الوصول إلى دليل متخصصي التجميل والعناية ومواعيدهم المتاحة مباشرةً، حتى تتمكّن التطبيقات والمساعدون ووكلاء الذكاء الاصطناعي من البحث والتوجيه نحو الحجز. كل ما يلي عام ولا يحتاج إلى مفتاح.
لوكلاء الذكاء الاصطناعي
وجّه مساعدًا يدعم MCP إلى نقطة الوصول أدناه، أو احصل على دليل llms.txt. تُعيد كل صفحة أيضًا صيغة Markdown عند طلبها بالترويسة «Accept: text/markdown».
خادم MCP
Model Context Protocol عبر Streamable HTTP. أرسل طلب «initialize» ثم «tools/list». الأدوات: search_businesses، get_business، check_availability، list_categories، list_cities، get_booking_link. ملف الاكتشاف على /.well-known/mcp.
curl -sS https://<host>/mcp \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize",
"params":{"protocolVersion":"2025-06-18","capabilities":{},
"clientInfo":{"name":"example","version":"1.0"}}}'واجهة REST
واجهة JSON للقراءة فقط. العقد الكامل موصوف في وثيقة OpenAPI 3.1.
نقاط الوصول
| GET | /api/mobile/v1/businesses?q=&city=&category=&clientele=&sort= | Search published professionals (also ?featured=1). |
| GET | /api/mobile/v1/businesses/{slug} | Full public profile: services, staff, hours, reviews. |
| GET | /api/mobile/v1/availability?businessId=&durationMinutes=&date= | Open slots for a day, or ?next=1&from= for the next available day. |
| POST | /api/mobile/v1/bookings | Create a booking (requires a signed-in client session). |
| POST | /mcp | MCP JSON-RPC (initialize, tools/list, tools/call). |
تُستكمل الحجوزات على الويب. يعيد MCP رابط حجز بدل إنشاء موعد؛ أما نقطة الوصول الموثَّقة POST /api/mobile/v1/bookings فتُنشئ حجزًا لعميل مسجَّل الدخول.
الموارد
- llms.txt — دليل الموقع القابل للقراءة آليًا
/llms.txt - مواصفة OpenAPI 3.1
/openapi.json - نقطة وصول MCP (Streamable HTTP)
/mcp - ملف اكتشاف MCP
/.well-known/mcp - خريطة الموقع XML
/sitemap.xml