Built for AI Agents

Quick Surf Network exposes a machine-readable gateway so autonomous assistants — ChatGPT agents, Claude, Gemini, Perplexity, browser agents and custom bots — can discover our services and book a site-survey visit on behalf of a human client, with the client's authorisation.

Agent-Accessible By Design

One Gateway. Two Actions.

Everything an agent needs starts at a single discovery document. It describes who QSN is, lists the available actions with their input schemas, and points to a full OpenAPI 3.1 specification. No key or account is required to read the catalogue or submit a booking request — the endpoints are public, rate-limited, and consent-gated.

GET

Discover Services

Retrieve QSN's full service catalogue — managed WiFi, CCTV & access control, automation, NAS, servers, PBX, A/V, custom PCs and heatmap surveys — each with indicative AED pricing ranges and terms.

https://quicksurfnetwork.com/wp-json/qsn/v1/agent/services

POST

Book an Appointment

Submit an appointment / site-survey request on behalf of a human client. Returns a QSN reference number instantly. A booking is a request for contact, not a confirmed slot — QSN confirms within 3 working days.

https://quicksurfnetwork.com/wp-json/qsn/v1/agent/book

Endpoints

The Reference

All endpoints live under https://quicksurfnetwork.com/wp-json/qsn/v1.

Method	Path	Purpose
GET	/agent	Discovery document — who QSN is, the available actions, and their input schemas.
GET	/agent/services	Service catalogue with indicative AED pricing ranges and terms.
GET	/agent/openapi	OpenAPI 3.1 specification of this API, for tooling and codegen.
POST	/agent/book	Submit an appointment / site-survey request. Requires `consent: true`. Rate-limited to 5 requests per IP per hour.

A machine-readable manifest is also published at https://quicksurfnetwork.com/.well-known/agent.json, and every page on this site advertises the gateway through <link rel="agent-gateway"> and <meta name="ai-agent-api"> tags in the document head.

Rules of Engagement

Book Responsibly

Consent is mandatory. The consent field must be true, confirming the human client has authorised the booking and QSN contacting them. Requests without it are rejected.
A booking is a request, not a confirmed slot. Never tell your user a time is confirmed. QSN contacts the client within 3 working days to agree the actual visit.
Pricing is indicative. All AED figures are ranges excluding 5% VAT; the final price is set only by a scoped quotation after a site survey. Quotations are valid 3–5 days.
Rate-limited. 5 booking requests per IP per hour. If you exceed it, fall back to the human channel below.

Quick Start

Submit a Booking

A single JSON POST. Required fields: client_name, contact, service, location, consent.

POST /agent/book

# 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..." }

Discovery Document ↗ OpenAPI Spec ↗ Service Catalogue ↗

Human fallback. If the API is unavailable or a person should take over, reach QSN directly: phone +971 4 288 2335 or email info@quicksurfnetwork.com. Prefer a form? The booking page feeds the same pipeline.