Hvem er jeg? Sjekk at nøkkelen virker

GET/api/v1/me

Virker

Det første kallet: viser verkstedet, nøkkelen (aldri hemmeligheten), delene som er slått på, og grensene. Avdelingene (locations) kommer: til verkstedet kan ha avdelinger, er feltet utelatt.

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

Svaret

200OKNøkkelen virker

application/jsonMe

organizationobjectMå med
Vis 2 feltSkjul 2 felt
- namestringMå med
- shopSlugstringMå medkan være null
keyobjectMå med
Vis 8 feltSkjul 8 felt
- namestringMå med
- prefixstringMå med
  Begynnelsen av nøkkelen, som vist i appen. Aldri hemmeligheten.
- environmentstringMå med
  Verdierlivetest
- purposestringMå med
  Verdiernettsideeget_systemkundeegendefinertmaskinregnearkleverandor
- scopesstring[]Må med
  Verdiercatalog:readprices:readorders:readorders:writeorders:statusagreements:readcustomers:readcustomers:writeinvoices:readproduction:readproduction:statusreports:read
- customerobjectMå medkan være null
  Satt når nøkkelen er en kundenøkkel.
  Vis 2 feltSkjul 2 felt
  - idstring · uuidMå med
    UUID
  - namestringMå med
- createdAtstring · date-timeMå medeks. 2026-12-14T09:03:00.000Z
  Tidspunkt, ISO 8601 i UTC
- expiresAtstring · date-timeMå medkan være nulleks. 2026-12-14T09:03:00.000Z
  Tidspunkt, ISO 8601 i UTC
featuresobjectMå med
Vis 6 feltSkjul 6 felt
- apibooleanMå med
- webhooksbooleanMå med
- shopbooleanMå med
- avtalerbooleanMå med
- lapperbooleanMå med
- kontorbooleanMå med
limitsobjectMå med
Vis 4 feltSkjul 4 felt
- perMinuteobjectMå med
  Vis 4 feltSkjul 4 felt
  - readintegerMå med
  - writeintegerMå med
  - pricesintegerMå med
  - uploadintegerMå med
- perDayobjectMå med
  Vis 4 feltSkjul 4 felt
  - allintegerMå med
  - pricesintegerMå med
  - ordersintegerMå med
  - ordersCustomerKeyintegerMå med
- perWorkshopPerDayintegerMå med
- failedLoginsobjectMå med
  Vis 2 feltSkjul 2 felt
  - limitintegerMå med
  - windowMinutesintegerMå med
modulesobject[]
Modulene verkstedet har slått på.
Vis 2 feltSkjul 2 felt
- keystringMå med
- statusstringMå med
  Verdieraktivpilot
locationsobject[]
Kommer: avdelingene, når verkstedet har to eller flere. Til avdelinger finnes, er feltet utelatt.
Vis 2 feltSkjul 2 felt
- idstring · uuidMå med
  UUID
- namestringMå med
apiVersionstringMå med
Alltid "v1"

Feilkoder

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

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.

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/me

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

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

$ch = curl_init('https://vbeslag.com/api/v1/me');
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

{
  "organization": {
    "name": "Nordvik Blikk AS",
    "shopSlug": "nordvik"
  },
  "key": {
    "name": "Nettsiden",
    "prefix": "vb_test_7Hq2",
    "environment": "live",
    "purpose": "nettside",
    "scopes": [
      "catalog:read"
    ],
    "customer": {
      "id": "87febf70-b0ae-4c70-a5cd-01339c01bce3",
      "name": "Byggmester Hansen AS"
    },
    "createdAt": "2026-12-14T09:03:00.000Z",
    "expiresAt": "2026-12-14T09:03:00.000Z"
  },
  "features": {
    "api": false,
    "webhooks": false,
    "shop": false,
    "avtaler": false,
    "lapper": false,
    "kontor": false
  },
  "limits": {
    "perMinute": {
      "read": 1,
      "write": 1,
      "prices": 1,
      "upload": 1
    },
    "perDay": {
      "all": 1,
      "prices": 1,
      "orders": 1,
      "ordersCustomerKey": 1
    },
    "perWorkshopPerDay": 1,
    "failedLogins": {
      "limit": 1,
      "windowMinutes": 1
    }
  },
  "modules": [
    {
      "key": "tekst",
      "status": "aktiv"
    }
  ],
  "locations": [
    {
      "id": "618ec085-5f44-48f5-a5c9-b270ec91c7f6",
      "name": "Byggmester Hansen AS"
    }
  ],
  "apiVersion": "v1"
}