For utviklere

SVING API

Integrer SVING med dine egne systemer. REST API med full dokumentasjon og OpenAPI-spesifikasjon.

REST API

Moderne REST API med JSON-format for enkel integrasjon med dine systemer.

OAuth 2.0

Sikker autentisering med OAuth 2.0 og API-nøkler for server-til-server.

OpenAPI 3.0

Full OpenAPI-spesifikasjon for automatisk generering av klienter.

Rate Limiting

1000 requests/minutt for standard, høyere grenser for Enterprise.

Kom i gang raskt

Vår API er designet for å være enkel å bruke. Her er et eksempel på hvordan du henter alle kjøretøy.

Bash / cURL
# Eksempel: Hent alle kjøretøy
curl -X GET "https://api.sving.no/v1/vehicles" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

# Response
{
  "data": [
    {
      "id": "veh_123abc",
      "make": "Volkswagen",
      "model": "Golf",
      "year": 2021,
      "price": 295000,
      "status": "available",
      "created_at": "2025-01-15T10:30:00Z"
    }
  ],
  "meta": {
    "total": 32,
    "page": 1,
    "per_page": 20
  }
}

API-endepunkter

Oversikt over tilgjengelige endepunkter. Se fullstendig dokumentasjon for detaljer.

Kjøretøy

GET/api/v1/vehiclesList alle kjøretøy
POST/api/v1/vehiclesOpprett nytt kjøretøy
GET/api/v1/vehicles/{id}Hent kjøretøy
PUT/api/v1/vehicles/{id}Oppdater kjøretøy
DELETE/api/v1/vehicles/{id}Slett kjøretøy

Leads

GET/api/v1/leadsList alle leads
POST/api/v1/leadsOpprett ny lead
GET/api/v1/leads/{id}Hent lead
PUT/api/v1/leads/{id}Oppdater lead

Kontrakter

GET/api/v1/contractsList alle kontrakter
POST/api/v1/contractsOpprett kontrakt
GET/api/v1/contracts/{id}/pdfLast ned PDF

Kommunikasjon

POST/api/v1/sms/sendSend SMS
POST/api/v1/email/sendSend e-post

Rapporter

GET/api/v1/analytics/salesSalgsstatistikk
GET/api/v1/analytics/leadsLead-statistikk
GET/api/v1/analytics/inventoryLageroversikt

Autentisering

API-nøkler

Autentiser forespørsler ved å inkludere API-nøkkelen din i Authorization-headeren:

Authorization: Bearer YOUR_API_KEY

API-nøkler kan genereres i SVING under Innstillinger → Integrasjoner → API. Hold nøkkelen hemmelig og del den aldri i klientside-kode.

API kun for Premium & Enterprise

API-tilgang er tilgjengelig for kunder på Premium- og Enterprise-planene. Kontakt oss for mer informasjon om API-tilgang.