B2B-dokumentasjon

B2B-API – hent bestillings- og produktinformasjon automatisert

Vårt REST-API er tilgjengelig for enhver kunde med kundekonto og gjør det mulig å hente bestillings- og produktinformasjon automatisert og integrere den i egne systemer.

vpn_key Åpne API-tilgang i kontoen Bedriftskunde-side

Autentisering

Alle API-forespørsler krever en gyldig API-Key som sendes med i HTTP-headeren. API-tilgangen er knyttet til kundekontoen din og er i utgangspunktet tilgjengelig for kundekontoer.

info Du trenger ingen separat B2B-søknad: Logg inn med kundekontoen din, åpne API-fanen og generer API-Key-en din der. Til API-tilgang →

Header-format

HTTP Request Header

X-API-Key: YOUR_API_KEY_HERE
Content-Type: application/json
Accept: application/json

Eksempel med cURL

cURL

curl -X GET "https://artumos.com/api/v1/orders" \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  -H "Accept: application/json"

Base URL

Alle endepunkter er relative til følgende Base URL:

Base URL

https://artumos.com/api/v1

Alle svar returneres som JSON returnert (Content-Type: application/json).

Rate Limits

Plan	Forespørsler / minutt	Forespørsler / dag
Kundekonto	60	5.000
Utvidet grense	på forespørsel	på forespørsel

Ved overskridelse returneres HTTP 429 Too Many Requests returnert. Headeren Retry-After inneholder ventetiden i sekunder.

Feilkoder

HTTP-Code	Betydning
`200 OK`	Forespørsel vellykket
`400 Bad Request`	Ugyldige parametere
`401 Unauthorized`	Manglende eller ugyldig API-Key
`403 Forbidden`	Ingen tilgang til denne ressursen
`404 Not Found`	Ressurs ikke funnet
`429 Too Many Requests`	Rate Limit overskredet
`500 Internal Server Error`	Serverfeil – kontakt support

Feilrespons-format

JSON

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key."
  }
}

Endepunkt: Bestillinger

GET /api/v1/orders Alle bestillinger til kontoen

Parameter	Type	Beskrivelse
`page`	integer	Side (standard: 1)
`per_page`	integer	Oppføringer per side (maks. 100)
`status`	string	`paid` \| `pending` \| `all`

Beispiel-Response

{
  "success": true,
  "data": {
    "orders": [
      {
        "id": "ORD-12345",
        "status": "paid",
        "total": 49.99,
        "currency": "EUR",
        "created_at": "2026-01-15T10:30:00Z",
        "items_count": 2
      }
    ],
    "pagination": {
      "page": 1,
      "per_page": 20,
      "total": 42
    }
  }
}

GET /api/v1/orders/{order_id} Hent enkeltbestilling

Endepunkt: Produkt- og bestillingsinformasjon

GET /api/v1/orders/{order_id}/codes All produktinformasjon for en bestilling

Beispiel-Response

{
  "success": true,
  "data": {
    "order_id": "ORD-12345",
    "codes": [
      {
        "id": "CODE-789",
        "product_name": "Beispielprodukt vom Marktplatz",
        "product_sku": "ART-PRODUCT-001",
        "product_info": "Hinweise laut Verkäuferangaben",
        "delivery_url": "https://...",
        "delivered_at": "2026-01-15T10:31:00Z",
        "status": "active"
      }
    ]
  }
}

GET /api/v1/codes/{code_id} Hent enkelt produktinformasjon

warning Produkt- og bestillingsinformasjon kan kun brukes innenfor rammen av den aktuelle bestillingen og selgeropplysningene. Misbruk ved videreformidling kan være i strid med bruksvilkårene.

Endepunkt: Produkter

GET /api/v1/products Hent produktkatalog

Parameter	Type	Beskrivelse
`category`	string	Filtrer kategori-slug
`in_stock`	boolean	Kun tilgjengelige produkter
`page`	integer	Side

Beispiel-Response

{
  "success": true,
  "data": {
    "products": [
      {
        "id": 42,
        "sku": "ART-PRODUCT-001",
        "name": "Beispielprodukt vom Marktplatz",
        "price": 49.99,
        "currency": "EUR",
        "in_stock": true,
        "category": "handmade"
      }
    ]
  }
}

Webhooks

Webhooks gjør det mulig å motta sanntidsvarsler når bestillinger eller koder gjøres tilgjengelig. Webhook-URL-er kan registreres i kundekontoen.

Tilgjengelige Events

Event	Beskrivelse
`order.paid`	Bestilling ble betalt
`codes.delivered`	Koder ble gjort tilgjengelig
`order.refunded`	Bestilling ble refundert

Webhook Payload

POST – Ditt Webhook-endepunkt

{
  "event": "codes.delivered",
  "timestamp": "2026-01-15T10:31:05Z",
  "data": {
    "order_id": "ORD-12345",
    "codes_count": 2
  },
  "signature": "sha256=..."
}

Verifiser signaturen med Webhook-Secret-en din: HMAC-SHA256(payload, webhook_secret)

Vanlige spørsmål

Hvem kan bruke B2B-API-et?

Enhver kunde med kundekonto kan bruke API-tilgangen. Logg inn på kundekontoen din og bruk den tilhørende API-Key-en for autentiserte forespørsler.

Hvilket format har svarene?

Alle svar returneres som JSON. Rotobjektet inneholder alltid success: true/false samt enten data eller error.

Kan jeg legge inn bestillinger via API?

I den første versjonen brukes API-et til å hente bestillinger samt bestillings- og produktinformasjon. Skrivende bestillings-endepunkter aktiveres separat så snart de er tilgjengelige.

Finnes det et Sandbox-miljø?

Ja. Sandbox kan aktiveres i kundekontoen under fanen „API-tilgang“ og er direkte knyttet til den aktuelle API-Key-en.