Demo tools

Le descrizioni degli endpoint e dei campi restano in inglese, esattamente come le pubblica l'API. È una scelta voluta: qui legge ciò che vedrà anche nelle risposte.

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.

Parametri

Risposte

Esempio di richiesta

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

Esempio di risposta

{
  "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.

Parametri

Risposte

Esempio di richiesta

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

Esempio di risposta

{
  "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.

Parametri

Risposte

Esempio di richiesta

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

Esempio di risposta

{
  "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
}

Schemi#

Error#

Error envelope returned for non-2xx responses.