توفّر Quick Surf Network بوابة قابلة للقراءة آلياً تتيح للمساعدات المستقلة — وكلاء ChatGPT وClaude وGemini وPerplexity ووكلاء المتصفح والبوتات المخصصة — اكتشاف خدماتنا وحجز زيارة مسح ميداني نيابة عن عميل بشري، بتفويض منه.
كل ما يحتاجه الوكيل يبدأ من وثيقة اكتشاف واحدة. تصف من هي QSN، وتسرد الإجراءات المتاحة مع مخططات مدخلاتها، وتشير إلى مواصفة OpenAPI 3.1 كاملة. ولا يلزم مفتاح ولا حساب لقراءة الكتالوج أو إرسال طلب حجز — فنقاط الوصول عامة، ومحدودة المعدل، ومشروطة بالموافقة.
استرجاع كتالوج خدمات QSN كاملاً — الواي فاي المُدار، والمراقبة والتحكّم بالدخول، والأتمتة، والتخزين الشبكي، والخوادم، وأنظمة الهاتف، والأنظمة الصوتية والمرئية، وتجميع الحواسيب، والمسوحات الحرارية — مع نطاقات أسعار إرشادية بالدرهم وشروطها.
https://quicksurfnetwork.com/wp-json/qsn/v1/agent/services
إرسال طلب موعد أو مسح ميداني نيابة عن عميل بشري. ويعيد رقماً مرجعياً من QSN فوراً. والحجز طلب تواصل، لا موعداً مؤكّداً — وتؤكّده QSN خلال 3 أيام عمل.
https://quicksurfnetwork.com/wp-json/qsn/v1/agent/book
جميع نقاط الوصول تقع تحت https://quicksurfnetwork.com/wp-json/qsn/v1.
| الطريقة | المسار | الغرض |
|---|---|---|
| GET | /agent | وثيقة الاكتشاف — من هي QSN، والإجراءات المتاحة، ومخططات مدخلاتها. |
| GET | /agent/services | كتالوج الخدمات مع نطاقات أسعار إرشادية بالدرهم وشروطها. |
| GET | /agent/openapi | مواصفة OpenAPI 3.1 لهذه الواجهة، للأدوات وتوليد الشيفرة. |
| POST | /agent/book | إرسال طلب موعد أو مسح ميداني. ويتطلب consent: true. محدود بـ5 طلبات لكل عنوان IP في الساعة. |
<link rel="agent-gateway"> و <meta name="ai-agent-api"> في ترويسة المستند. consent يجب أن يكون true، تأكيداً بأن العميل البشري فوّض الحجز وتواصل QSN معه. والطلبات التي تخلو منه تُرفض.
طلب JSON واحد بطريقة POST. والحقول المطلوبة: client_name, contact, service, location, consent.
# Book a managed-WiFi site survey on a client's behalf curl -X POST "https://quicksurfnetwork.com/wp-json/qsn/v1/agent/book" \ -H "Content-Type: application/json" \ -d '{ "client_name": "Ahmed Al Marri", "contact": "+971 50 123 4567 / ahmed@example.ae", "service": "managed-wifi", "location": "Dubai, Al Barsha", "preferred_time": "morning", "notes": "4-bed villa, dead zones upstairs", "agent_name": "ExampleAssistant", "consent": true }' # → { "ok": true, "ref": "QSN-...", "status": "received", # "next_step": "QSN will contact the client within 3 working days..." }