B2B-dokumentation

B2B API – hent bestillings- og produktinformationer automatisk

Vores REST-API er tilgængelig for enhver kunde med kundekonto og gør det muligt automatisk at hente bestillings- og produktinformationer og integrere dem i egne systemer.

vpn_key Åbn API-adgang i kontoen Erhvervskunde-side

Godkendelse

Alle API-anmodninger kræver en gyldig API-key, som sendes med i HTTP-headeren. API-adgangen er knyttet til din kundekonto og er som udgangspunkt tilgængelig for kundekonti.

info Du behøver ikke en separat B2B-ansøgning: Log ind med din kundekonto, åbn API-fanen og generér din API-key der. Til API-adgang →

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 endpoints er relative i forhold til følgende Base URL:

Base URL

https://artumos.com/api/v1

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

Rate Limits

Plan	Anmodninger / minut	Anmodninger / dag
Kundekonto	60	5.000
Udvidet grænse	på forespørgsel	på forespørgsel

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

Fejlkoder

HTTP-Code	Betydning
`200 OK`	Anmodning lykkedes
`400 Bad Request`	Ugyldige parametre
`401 Unauthorized`	Manglende eller ugyldig API-key
`403 Forbidden`	Ingen tilladelse til denne ressource
`404 Not Found`	Ressource ikke fundet
`429 Too Many Requests`	Rate Limit overskredet
`500 Internal Server Error`	Serverfejl – kontakt venligst support

Fejl-response-format

JSON

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

Endpoint: Bestillinger

GET /api/v1/orders Alle kontoens bestillinger

Parameter	Type	Beskrivelse
`page`	integer	Side (standard: 1)
`per_page`	integer	Poster pr. 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 enkelt bestilling

Endpoint: Produkt- og bestillingsinformationer

GET /api/v1/orders/{order_id}/codes Alle produktinformationer 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 produktinformation

warning Produkt- og bestillingsinformationer må kun anvendes inden for rammerne af den pågældende bestilling og sælgeroplysninger. Misbrug ved videregivelse kan udgøre en overtrædelse af brugsbetingelserne.

Endpoint: Produkter

GET /api/v1/products Hent produktkatalog

Parameter	Type	Beskrivelse
`category`	string	Filtrér på kategori-slug
`in_stock`	boolean	Kun tilgængelige 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 gør det muligt at modtage notifikationer i realtid, når bestillinger eller koder stilles til rådighed. Webhook-URL'er kan registreres i kundekontoen.

Tilgængelige Events

Event	Beskrivelse
`order.paid`	Bestilling blev betalt
`codes.delivered`	Koder blev stillet til rådighed
`order.refunded`	Bestilling blev refunderet

Webhook Payload

POST – Dit Webhook-endpoint

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

Verificér signaturen med din Webhook-secret: HMAC-SHA256(payload, webhook_secret)

Ofte stillede spørgsmål

Hvem kan bruge B2B API?

Enhver kunde med kundekonto kan bruge API-adgangen. Log ind på din kundekonto og brug den tilhørende API-key til godkendte anmodninger.

Hvilket format har svarene?

Alle svar returneres som JSON. Root-objektet indeholder altid success: true/false samt enten data eller error.

Kan jeg afgive bestillinger via API?

I den første version bruges API'en til at hente bestillinger samt bestillings- og produktinformationer. Skrivende bestillings-endpoints frigives separat, så snart de er tilgængelige.

Findes der et sandbox-miljø?

Ja. Sandboxen kan aktiveres i kundekontoen under fanen „API-adgang“ og er knyttet direkte til den pågældende API-key.