Demo tools

Οι περιγραφές των endpoints και των πεδίων εμφανίζονται στα αγγλικά, όπως ακριβώς τις δημοσιεύει το API. Είναι επιλογή μας, ώστε να διαβάζετε εδώ ό,τι θα δείτε και στις αποκρίσεις.

GET /v1/demo/bookings#

Demo: a customer's bookings. Same fixture family: no key, CORS-open, deterministic per reference, nothing stored. Bookings come back in the shape the calendar API uses, so a template built against the demo moves to the real calendar without changing the prompt.

Παράμετροι

Αποκρίσεις

Παράδειγμα αιτήματος

curl "https://api.voiceland.ai/v1/demo/bookings" \
  -H "Authorization: Bearer VL_API_KEY"

Παράδειγμα απόκρισης

{
  "bookings": [
    {
      "attendees": [
        {
          "email": "maria@example.com",
          "name": "Maria Papadopoulou"
        }
      ],
      "duration_min": 30,
      "end": "2026-09-15T10:30:00+03:00",
      "meeting_url": "https://example.com/demo-1",
      "start": "2026-09-15T10:00:00+03:00",
      "status": "accepted",
      "timezone": "Europe/Athens",
      "title": "Consultation",
      "uid": "bk-1a2b3c"
    }
  ],
  "demo": true,
  "timezone": "Europe/Athens"
}

GET /v1/demo/orders#

Demo: look up an order. A fixture for trying custom tools before you own an API, the demo agent templates point their tools here. No key and CORS-open, so it also works as a visitor-executed tool from a browser. Deterministic: the same order_id always returns the same order; without one it returns three recent orders as {"orders": […], "demo": true}. Nothing is stored.

Παράμετροι

Αποκρίσεις

Παράδειγμα αιτήματος

curl "https://api.voiceland.ai/v1/demo/orders" \
  -H "Authorization: Bearer VL_API_KEY"

Παράδειγμα απόκρισης

{
  "carrier": "Courier",
  "estimated_delivery": "2026-09-15",
  "items": [
    {
      "name": "Noise-cancelling headset",
      "price_eur": 149,
      "quantity": 1,
      "sku": "VL-HS-02"
    },
    {
      "name": "USB-C cable, 2m",
      "price_eur": 12.9,
      "quantity": 1,
      "sku": "VL-CB-07"
    }
  ],
  "order_id": "A-1008",
  "placed_on": "2026-09-08",
  "status": "shipped",
  "total_eur": 161.9,
  "tracking_number": "TRK1234567890"
}

GET /v1/demo/temperatures#

Demo: current weather for a city. Same fixture family as /demo/orders: no key, CORS-open, deterministic per city, nothing stored. Defaults to Athens.

Παράμετροι

Αποκρίσεις

Παράδειγμα αιτήματος

curl "https://api.voiceland.ai/v1/demo/temperatures" \
  -H "Authorization: Bearer VL_API_KEY"

Παράδειγμα απόκρισης

{
  "city": "Athens",
  "conditions": "clear",
  "feels_like_c": 23,
  "humidity_pct": 41,
  "observed_at": "2026-09-13T12:00:00+03:00",
  "temperature_c": 24,
  "wind_kph": 12
}

Σχήματα#

Error#

Error envelope returned for non-2xx responses.