REST API

Läs ut projekt, material och anpassade EPD:er programmatiskt. Perfekt för integration med BI-verktyg, interna dashboards eller automatiserade rapporter.

Ladda ner OpenAPI-spec (JSON)Öppna i Swagger Editor

API-nyckel

Autentisering via X-API-Key-header. Nycklar hanteras under Organisation → API-nycklar.

Read-only

API:et är skrivskyddat. Du kan läsa projekt, material och EPD:er men inte skapa eller ändra data.

JSON

Alla svar returneras som JSON. HTTP-statuskoder följer standarden (200, 401, 404, 500).

Autentisering

Varje begäran måste innehålla en giltig API-nyckel i headern X-API-Key. Nyckeln är kopplad till din organisation och ger åtkomst till organisationens projekt och EPD:er.

Exempel på header

X-API-Key: kk_a1b2c3d4e5f6...

Så skapar du en API-nyckel

Logga in på Klimatkalkylatorn.
Klicka på organisationens namn i huvudmenyn.
Gå till fliken API-nycklar.
Ange ett namn (t.ex. "Power BI-rapport") och klicka på Skapa.
Kopiera nyckeln direkt — den visas bara en gång.

Viktigt

Förvara din API-nyckel säkert och dela den aldrig publikt. Om en nyckel kommer på avvägar kan du återkalla den när som helst under Organisation → API-nycklar. Återkallade nycklar slutar fungera direkt.

Bas-URL

Base URL

https://rakeqijnhsfexbsleygm.supabase.co/functions/v1/public-api

Alla endpoints prefixas med bas-URL:en ovan. API:et körs som en Edge Function och stöder CORS för anrop från webbläsare.

Endpoints

GET

/projects

Lista alla projekt i organisationen med översiktlig information.

Svarsexempel (200 OK)

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Bostadshus Kv. Rådjuret",
      "building_type": "flerbostadshus",
      "property_designation": "Rådjuret 1",
      "gross_floor_area": 2400,
      "status": "active",
      "created_at": "2025-01-15T08:30:00Z",
      "updated_at": "2025-02-20T14:15:00Z"
    }
  ]
}

GET

/projects/:id

Hämta ett enskilt projekt inklusive all metadata och tillhörande material.

Parametrar

:idProjektets UUID (obligatorisk)

Svarsexempel (200 OK)

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Bostadshus Kv. Rådjuret",
    "building_type": "flerbostadshus",
    "gross_floor_area": 2400,
    "materials": [
      {
        "id": "...",
        "material_id": "boverket-123",
        "name": "Betong C30/37",
        "quantity": 150000,
        "unit": "kg",
        "building_part": "Bjälklag"
      }
    ]
  }
}

GET

/projects/:id/materials

Hämta enbart material-listan för ett specifikt projekt.

Parametrar

:idProjektets UUID (obligatorisk)

Svarsexempel (200 OK)

{
  "data": [
    {
      "id": "...",
      "material_id": "boverket-123",
      "name": "Betong C30/37",
      "quantity": 150000,
      "unit": "kg",
      "building_part": "Bjälklag",
      "input_type": "weight"
    }
  ]
}

GET

/epds

Lista organisationens anpassade EPD:er (Environmental Product Declarations).

Svarsexempel (200 OK)

{
  "data": [
    {
      "id": "...",
      "name": "Egen betongblandning",
      "a1a3_co2e": 0.089,
      "unit": "kg",
      "organization_id": "...",
      "created_at": "2025-03-01T10:00:00Z"
    }
  ]
}

Kodexempel

cURL

# Lista projekt
curl -H "X-API-Key: kk_DIN_API_NYCKEL"   https://rakeqijnhsfexbsleygm.supabase.co/functions/v1/public-api/projects

# Hämta projekt med material
curl -H "X-API-Key: kk_DIN_API_NYCKEL"   https://rakeqijnhsfexbsleygm.supabase.co/functions/v1/public-api/projects/550e8400-e29b-41d4-a716-446655440000

# Hämta material för projekt
curl -H "X-API-Key: kk_DIN_API_NYCKEL"   https://rakeqijnhsfexbsleygm.supabase.co/functions/v1/public-api/projects/550e8400-e29b-41d4-a716-446655440000/materials

# Lista EPD:er
curl -H "X-API-Key: kk_DIN_API_NYCKEL"   https://rakeqijnhsfexbsleygm.supabase.co/functions/v1/public-api/epds

Felkoder

Status	Betydelse
401	Saknad eller ogiltig `X-API-Key`. Kontrollera att nyckeln är aktiv och skriven korrekt.
404	Resursen hittades inte eller tillhör inte din organisation.
500	Internt serverfel. Försök igen senare eller kontakta support.

Behöver du hjälp?

Om du har frågor om API:et eller behöver anpassade integrationer, kontakta din organisations administratör eller använd kontaktformuläret på webbplatsen.

Tillbaka till kalkylatorn