SIZWALL
Utvecklare

Bygg in kroppsdata i din produkt.

Sizewall erbjuder ett REST-API för att starta kroppsskanningar från din applikation, hämta strukturerade mätdata och valfritt ladda ner en 3D-modell av kroppen.

Begär API-nycklar →

Översikt

Översikt

Sizewall låter dig starta en skanning direkt från din app, ta emot en sömlös redirect tillbaka när användaren är klar, få webhook-notifieringar och hämta strukturerade mått via REST. 3D-modellen i OBJ-format är valfri.

Därför integrerar man Sizewall

  • Starta skanningar direkt från din app
  • Sömlös redirect efter avslutad skanning
  • Webhook-notiser i realtid
  • Strukturerade mått via REST
  • Valfri åtkomst till 3D-modell

Integrationsflöde

Integrationsflöde

Sex steg från användarklick till sparad mätning.

  1. 01

    Skapa profil

    En profil per slutanvändare i Sizewall.

  2. 02

    Skapa session

    Sessionen genererar en ticketUrl för engångsbruk.

  3. 03

    Redirecta användaren

    Skicka användaren till Sizewalls skanner i webbläsare eller webview.

  4. 04

    Användaren skannar

    Två foton tas och bearbetas av vår AI.

  5. 05

    Redirect + webhook

    Vi skickar tillbaka användaren och pingar din webhook.

  6. 06

    Hämta mått

    Mätdata och valfri 3D-modell hämtas via API.

Användarupplevelse

Användarupplevelse

Två skärmar mellan din app och Sizewalls skanner — en för att starta, en när användaren kommer tillbaka.

1. Starta skanningen

När din backend skapar en session får du tillbaka en ticketUrl. Öppna den i en webbläsare eller en webview.

Skärm: starta skanning

2. Tillbaka till din app eller sajt

När skanningen är klar redirectar Sizewall användaren tillbaka via redirect-URL:n du angav.

Skärm: skanningen klar

Här kan ditt system visa en "Bearbetar"- eller "Resultat klart"-vy. Mätdata hämtas via API. Vi rekommenderar att du lyssnar på webhook-notisen för bekräftelse på att bearbetningen är klar.

Koncept

Kärnkoncept

Fyra resurser bygger upp Sizewall-API:et.

  • 01

    Profil

    Representerar en användare i Sizewall. En profil per slutanvändare.

  • 02

    Session

    En enskild skanning. Ger en engångs-ticketUrl, stöder redirect- och webhook-URL:er, kortlivad och engångsanvändning.

  • 03

    Mätning

    Bearbetade skanningsresultat — strukturerade kroppsmått (midja, bröst, höft m.fl.) och valfria kompositionsvärden som body_fat.

  • 04

    3D-modell

    Valfri OBJ-modell (Wavefront) genererad från skanningen. Hämtas per mätning via dedikerad endpoint.

Autentisering

Autentisering

Sizewall använder maskin-till-maskin-autentisering via OAuth2 Client Credentials, utfärdad genom Microsoft Entra ID. Alla anrop kräver en Bearer-token i Authorization-headern. Tokens är kortlivade och måste förnyas innan de går ut.

Header
Authorization: Bearer ACCESS_TOKEN

Kom igång

Kom igång

Sju steg från första anropet till nedladdad 3D-modell.

  1. 01Skapa en Profile med användardetaljer
  2. 02Skapa en Session med redirect- och webhook-URL:er
  3. 03Redirecta användaren till ticketUrl i webbläsaren eller webview
  4. 04Hantera redirect-callbacken och webhook-notisen
  5. 05Hämta mätningar via API när skanningen är klar
  6. 06Mappa mätdatan till din produktupplevelse
  7. 07Ladda valfritt ned 3D-modellen i binärt, Base64 eller JSON-format
Exempel — skapa session
curl -X POST https://api.sizewall.com/v1/profiles/{profileID}/sessions \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "redirectUrl": "https://app.example.com/scan/complete",
    "webhookUrl": "https://api.example.com/sizewall/webhook"
  }'

Webhooks

Webhooks

När en session slutförs gör Sizewall en POST mot din webhook med eventet session.completed. Varje webhook inkluderar ett unikt eventId — spara processade ID:n och kontrollera dubbletter innan du agerar på payloaden.

Payload
{
  "type": "session.completed",
  "eventId": "evt_01H9X...",
  "createdAt": "2026-05-25T09:14:21Z",
  "profileID": "prf_...",
  "sessionID": "ses_...",
  "measurementID": "mea_...",
  "status": "success",
  "error": null,
  "links": { "measurement": "..." }
}

Best practices

Best practices

  • 01Skapa en ny session per skanning — sessioner är engångs
  • 02Använd webhooks istället för polling för pålitliga notiser
  • 03Spara profile-ID:n för att koppla mätningar till användare
  • 04Hantera redirects mjukt med loading-state
  • 05Förvara tokens säkert och förnya innan de går ut
  • 06Implementera exponentiell backoff för retries
  • 07Använd eventId för idempotent webhook-hantering

API-referens

API-referens

REST-endpoints, grupperade per resurs.

Bas-URL

https://api.sizewall.com/v1

Autentisering

Bearer-token (OAuth2 Client Credentials, Microsoft Entra ID)

Profiler

  • POST/profilesSkapa en ny profil
  • GET/profiles/{profileID}Hämta en profil
  • PUT/profiles/{profileID}Uppdatera en profil
  • DELETE/profiles/{profileID}Ta bort en profil
  • GET/profiles/{profileID}/linkHämta eller generera delbar länk
  • POST/profiles/{profileID}/linkGenerera ny delbar länk

Sessioner

  • POST/profiles/{profileID}/sessionsStarta ny session för en profil (valfri webhookUrl)
  • GET/profiles/{profileID}/sessions/{sessionID}Hämta sessionsdetaljer

Mätningar

  • GET/profiles/{profileID}/measurementsLista alla mätningar för en profil
  • GET/profiles/{profileID}/measurements/{measurementID}Hämta en specifik mätning
  • DELETE/profiles/{profileID}/measurements/{measurementID}Ta bort en mätning
  • GET/profiles/{profileID}/measurements/{measurementID}/modelHämta 3D-modell för mätning

HTTP-statuskoder

  • 200OK (läsoperationer)
  • 201Resurs skapad
  • 204OK (uppdatera / radera)
  • 400Ogiltig input
  • 401Saknad eller ogiltig token
  • 404Hittas inte
  • 409Dubblerad resurs
  • 410Webhook-URL ogiltig
  • 429Rate limit överskriden
  • 500Serverfel

Använd exponentiell backoff (max 3 försök) för 429 och 5xx.

OpenAPI

OpenAPI-spec

Full maskinläsbar specifikation i OpenAPI 3.0-format.

Ladda ner OpenAPI YAML ↓

Redo att börja bygga?

Be om API-nycklar så hjälper vi dig komma igång.

Begär åtkomst