Utvecklare

Bygg på LAPX

Ett öppet REST-API med API-nycklar och webhooks. Koppla ert TMS, WMS, e-handel eller ekonomisystem mot LAPX — hämta in ordrar, skicka statusar och håll allt i synk automatiskt.

Introduktion

LAPX-API:et följer REST-principer, använder JSON i både förfrågan och svar, och autentiseras med API-nycklar. Alla anrop går över HTTPS mot bas-URL:en nedan. Samma API driver kundportalen och appen för fältet — det ni bygger kör mot exakt samma data som resten av systemet.

Bas-URL https://api.lapx.se

Kom igång

  1. Kontakta oss så utfärdar vi en API-nyckel för er tenant.
  2. Skicka nyckeln som en Authorization: Bearer-header.
  3. Gör ert första anrop mot /v1/jobs.
  4. Registrera en webhook för att få statusar tillbaka i realtid.

Autentisering

Varje anrop kräver en API-nyckel i Authorization-headern. Nycklar är knutna till en tenant och kan begränsas till läs- eller skrivbehörighet. Dela aldrig nyckeln i klientkod.

curl https://api.lapx.se/v1/jobs \
  -H "Authorization: Bearer LAPX_API_KEY" \
  -H "Content-Type: application/json"

Endpoints

Ett urval av de vanligaste resurserna:

GET /v1/jobs Lista jobb (filtrera på status, datum, kund).
POST /v1/jobs Skapa ett nytt jobb.
GET /v1/jobs/{id} Hämta ett enskilt jobb.
GET /v1/orders Lista ordrar.
POST /v1/orders Skapa en order som blir till jobb.
GET /v1/customers Lista kunder i ert register.
GET /v1/tracking/{ref} Publik statussida för en referens.
GET /v1/invoices Lista fakturaunderlag.
POST /v1/webhooks Registrera en webhook-endpoint.

Exempel: skapa ett jobb

POST https://api.lapx.se/v1/jobs
Authorization: Bearer LAPX_API_KEY
Content-Type: application/json

{
  "reference": "ORD-10482",
  "type": "field",
  "customer":     { "name": "Mottagare AB", "zip": "11122", "city": "Stockholm" },
  "scheduled_at": "2026-09-12T08:00:00Z",
  "lines": [{ "description": "Utfört arbete", "quantity": 2, "unit": "tim" }]
}

Webhooks

Registrera en URL så skickar vi en POST med JSON varje gång något händer. Perfekt för att spegla statusar tillbaka till ert system.

job.created Ett nytt jobb har skapats.
job.status_changed Ett jobb har bytt status.
job.completed Ett jobb är klart, med bevis/kvitto.
invoice.created Ett nytt fakturaunderlag är klart.

Exempel-payload

{
  "event": "job.status_changed",
  "created_at": "2026-09-09T08:14:22Z",
  "data": {
    "id": "job_8Xa2...",
    "reference": "ORD-10482",
    "status": "in_progress"
  }
}

Fel & statuskoder

200 · 201 OK / skapad.
400 Felaktig förfrågan — kontrollera fälten.
401 Saknad eller ogiltig API-nyckel.
403 Nyckeln saknar behörighet till resursen.
404 Resursen finns inte.
429 För många anrop — se rate limits.
5xx Fel hos oss. Försök igen, hör av er om det kvarstår.

Rate limits

Standardgränsen är 600 anrop per minut och nyckel. Överskrids den svarar API:et med 429 och en Retry-After-header. Behöver ni högre gräns för en integration hör ni av er.

Redo att börja bygga?

Vi utfärdar en API-nyckel och hjälper er igång med första kopplingen.

Begär API-nyckel