Beslagene i nettbutikken

GET/api/v1/catalog/products

Virker

Butikkens publiserte beslag, i samme form som butikken viser dem.

Rettigheter: catalog:read
Kundenøkkel: Ja, for sine egne
Grense: lesing, 120 i minuttet
Siden: 5. oktober 2026

Parametre

I spørringen

limitinteger1–100
Antall per side, 1–100 (25 når den mangler).
cursorstringhøyst 400 tegn
nextCursor fra forrige side.

Svaret

200OKBeslagene

application/jsonProductList

dataProduct[]Må med
Vis 14 feltSkjul 14 felt
- idstring · uuidMå med
  UUID
- slugstringMå med
- titlestringMå med
- descriptionstringMå medkan være null
- categorystringMå medkan være null
- kindstringMå med
  Verdierprofilsektorkuttliste
- fieldsobject[]Må med
  Vis 6 feltSkjul 6 felt
  - keystringMå med
  - labelstringMå med
  - defaultnumberMå med
  - minnumberMå med
  - maxnumberMå med
  - unitstringMå med
- fixedRecord<string, number>Må mednøklene er tekst
- materialsobject[]Må med
  Vis 3 feltSkjul 3 felt
  - idstring · uuidMå med
    UUID
  - namestringMå med
  - colourstringMå medkan være null
- mediaobject[]Må med
  Bildene av beslaget. 3D-modellen (model) kommer: til nettbutikken har en offentlig adresse for den, er listen bare bilder.
  Vis 3 feltSkjul 3 felt
  - kindstringMå med
    Verdierimagemodel
  - urlstringMå med
  - namestringMå med
- drawingUrlstringMå medkan være null
  Kommer: alltid null til nettbutikken har en offentlig adresse for tegningen.
- priceFromOreintegerMå medkan være null
  Hele øre (1 kr = 100 øre)
- priceShownbooleanMå med
- updatedAtstring · date-timeMå medeks. 2026-12-14T09:03:00.000Z
  Tidspunkt, ISO 8601 i UTC
nextCursorstringMå medkan være null

Feilkoder

Alle feil har samme form. Velg handling etter code, aldri etter message. Les mer under Feil.

400Bad Request

invalid_cursorMarkøren (cursor) er ikke en vi har gitt ut.
invalid_requestNoe i forespørselen er feil eller ukjent. fields sier hva.

401Unauthorized

unauthorizedNøkkelen mangler, er feil, er slått av eller har gått ut. En nøkkel som slås av, slutter å virke innen 1 minutt.

403Forbidden

account_closedVerkstedet er stengt.
dpa_requiredVerkstedet må godta databehandleravtalen før koblinger kan brukes.
feature_not_in_planVerkstedet har ikke slått på delen dette trenger. feature sier hvilken.
insufficient_scopeNøkkelen har ikke lov til dette. requiredScope sier hvilken rett som mangler.

429Too Many Requests

rate_limitedFor mange kall. Vent retryAfterSeconds sekunder.

500Internal Server Error

internalNoe gikk galt hos oss. Feilen er meldt. Oppgi requestId hvis du spør.

GET/catalog/products

curl https://vbeslag.com/api/v1/catalog/products \
  -H "Authorization: Bearer vb_test_…"

const res = await fetch('https://vbeslag.com/api/v1/catalog/products', {
  headers: {
    Authorization: 'Bearer vb_test_…',
  },
})
const data = await res.json()

$ch = curl_init('https://vbeslag.com/api/v1/catalog/products');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer vb_test_…',
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Svaret

HTTP/1.1 200 OK
Content-Type: application/json

{
  "data": [
    {
      "id": "87d0d3bb-82a2-474b-a62b-e3e26da70c48",
      "slug": "nordvik",
      "title": "Pipebeslag",
      "description": "Vindskie 150×40, stål sort",
      "category": "tekst",
      "kind": "profil",
      "fields": [
        {
          "key": "tekst",
          "label": "tekst",
          "default": 1.5,
          "min": 1.5,
          "max": 1.5,
          "unit": "stk"
        }
      ],
      "fixed": {
        "a": 1.5
      },
      "materials": [
        {
          "id": "6a638847-b37b-4817-a5b2-a01e54319774",
          "name": "Byggmester Hansen AS",
          "colour": "Sort"
        }
      ],
      "media": [
        {
          "kind": "image",
          "url": "https://vbeslag.com/betal/x9Qa",
          "name": "Byggmester Hansen AS"
        }
      ],
      "drawingUrl": "https://vbeslag.com/tegning/x9Qa.svg",
      "priceFromOre": 61200,
      "priceShown": false,
      "updatedAt": "2026-12-14T09:03:00.000Z"
    }
  ],
  "nextCursor": "tekst"
}