Utvecklare

API &integration.

Integrera offert-flödet och bokningssystemet med din befintliga webbplats — via ditt eget formulär eller REST API.

Offert-flöde från din egen webbplats

Använd ditt eget formulär — kunden skickas automatiskt till en signerbar offert

Bygg formuläret precis som du vill på din egen webbplats. Lägg till attributet data-sparkle-offert på ditt <form> och inkludera skriptet nedan. Vid inskick skapas offerten automatiskt och kunden omdirigeras till signeringssidan med alla uppgifter och exakt pris.

<script src="https://sparkleplatform.se/api/public/offert/connect.js"
        data-tenant="DIN-SLUG" defer></script>

<form data-sparkle-offert>
  <select name="service_type">
    <option value="hemstadning">Hemstädning</option>
    <option value="flyttstadning">Flyttstädning</option>
    <option value="kontorsstadning">Kontorsstädning</option>
    <option value="byggstadning">Byggstädning</option>
    <option value="storstadning">Storstädning</option>
    <option value="visningsstadning">Visningsstädning</option>
  </select>
  <input name="first_name" placeholder="Förnamn" required />
  <input name="last_name" placeholder="Efternamn" required />
  <input name="phone" placeholder="Telefon" required />
  <input name="email" type="email" placeholder="E-post" required />
  <input name="street" placeholder="Gata" required />
  <input name="house_no" placeholder="Nr" required />
  <input name="postal_code" placeholder="Postnummer" required />
  <input name="city" placeholder="Stad" required />
  <input name="sqm" type="number" placeholder="Yta (m²)" required />
  <select name="balkong">
    <option value="ingen">Ingen balkong</option>
    <option value="liten">Liten</option>
    <option value="stor">Stor</option>
  </select>
  <input name="desired_date" type="date" />
  <input name="desired_time" type="time" />
  <textarea name="message" placeholder="Meddelande"></textarea>
  <button type="submit">Få offert direkt</button>
</form>

Så fungerar det

  1. Kunden fyller i formuläret på din webbplats
  2. Offerten skapas automatiskt med exakt pris (din prissättning per tjänst + RUT)
  3. Den signerbara offerten öppnas som en overlay på din sida — URL:en ändras aldrig
  4. Vid signering skapas bokningen automatiskt med önskat datum & tid

Eget anrop (utan skript)

POST:a fälten som JSON till /api/public/offert/{din-slug} och omdirigera kunden till offert_url från svaret.

REST API

Fullständig kontroll med vårt API

Autentisering

Offert-endpoints (/api/public/offert/* och /api/public/quotes/*) är publika och kräver ingen nyckel — de identifieras via din företagsslug. Övriga boknings-endpoints kräver en API-nyckel i X-API-Key headern.

X-API-Key: sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Endpoints

GET/api/public/offert/{slug}/config

Hämta offert-konfiguration: aktiva tjänster med m²-priser, RUT-status, balkongpriser och gränser

Kodexempel

curl -X GET "https://sparkleplatform.se/api/public/offert/{slug}/config"

Response

{
  "company_name": "Servora",
  "brand_color": "#0ea5e9",
  "min_sqm": 20,
  "max_sqm": 500,
  "services": [
    { "id": "hemstadning", "name": "Hemstädning", "m2_price": 35, "rut_eligible": true },
    { "id": "flyttstadning", "name": "Flyttstädning", "m2_price": 45, "rut_eligible": true },
    { "id": "kontorsstadning", "name": "Kontorsstädning", "m2_price": 30, "rut_eligible": false },
    { "id": "byggstadning", "name": "Byggstädning", "m2_price": 50, "rut_eligible": false },
    { "id": "storstadning", "name": "Storstädning", "m2_price": 45, "rut_eligible": true },
    { "id": "visningsstadning", "name": "Visningsstädning", "m2_price": 40, "rut_eligible": true }
  ]
}