API og MCP for utviklere

Kom i gang på tre steg

1. Steg 1

   Lag en API-nøkkel

   Logg inn, gå til Innstillinger → API og integrasjoner og velg Ny API-nøkkel. Velg Les eller Les og skriv. Nøkkelen vises én gang.

2. Steg 2

   Test at den virker

   Hent kalenderne dine med nøkkelen. Svarer https://api.voximate.no med en liste, er du koblet til.

3. Steg 3

   Koble til systemet eller AI-en

   Bruk REST-API-et fra din egen kode, eller legg MCP-serveren inn i Claude, Cursor eller n8n.

curl "https://api.voximate.no/booking/calendars" \
  -H "Authorization: Bearer vox_live_…"

AI-assistenter med MCP

MCP-serveren lar en AI-assistent finne ledig tid, finne eller lage kunden og booke, med de samme reglene som i appen. En lesenøkkel får bare verktøyene som henter data.

https://api.voximate.no/booking/mcp

Verktøy

list_calendars, list_services, find_free_slots, search_customers, get_customer, list_customer_appointments, create_customer, list_appointments, get_appointment, create_appointment, update_appointment, cancel_appointment

claude mcp add --transport http voximate-booking https://api.voximate.no/booking/mcp --header "Authorization: Bearer vox_live_…"

{
  "mcpServers": {
    "voximate-booking": {
      "url": "https://api.voximate.no/booking/mcp",
      "headers": {
        "Authorization": "Bearer vox_live_…"
      }
    }
  }
}

{
  "mcpServers": {
    "voximate-booking": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.voximate.no/booking/mcp",
        "--header",
        "Authorization:${AUTH}"
      ],
      "env": {
        "AUTH": "Bearer vox_live_…"
      }
    }
  }
}

REST-API

• Base-URL: https://api.voximate.no
• Send nøkkelen i headeren Authorization: Bearer vox_live_…
• Nøkkelen gir bare tilgang til /booking/*.
• JSON inn og ut.
• Tider er i Europe/Oslo: date er YYYY-MM-DD, startMinute og endMinute er minutter etter midnatt (600 = 10:00).
• En lesenøkkel kan bare bruke GET.

Hent ledige tider

curl "https://api.voximate.no/booking/free-slots?serviceId=SERVICE_ID" \
  -H "Authorization: Bearer vox_live_…"

Book en avtale

curl -X POST "https://api.voximate.no/booking/appointments" \
  -H "Authorization: Bearer vox_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "calendarId": "CALENDAR_ID",
    "date": "2026-11-03",
    "startMinute": 600,
    "endMinute": 660,
    "customerId": "CUSTOMER_ID",
    "serviceIds": ["SERVICE_ID"],
    "customerNote": "Booket fra nettsiden"
  }'

Feilkoder

401

API_KEY_INVALID

Ugyldig, utløpt eller slettet nøkkel.

403

API_KEY_READ_ONLY

En lesenøkkel prøvde å skrive.

403

API_KEY_SCOPE

Adressen ligger utenfor /booking.

403

forbidden

Rollen til brukeren som lagde nøkkelen, har ikke tilgang.

402

Booking-abonnementet er utløpt.

409

slot_taken

Tiden ble nettopp tatt. Hent ledige tider på nytt.

429

RATE_LIMIT_EXCEEDED

For mange forespørsler. Vent så mange sekunder som Retry-After sier.

Behandle nøkkelen som et passord. Lag én nøkkel per system, så kan du slette én uten å stoppe de andre.