B2B-dokumentation

B2B API – hämta beställnings- och produktinformation automatiserat

Vårt REST-API är tillgängligt för alla kunder med kundkonto och gör det möjligt att hämta beställnings- och produktinformation automatiserat och integrera den i egna system.

vpn_key Öppna API-åtkomst i kontot Företagskundssida

Autentisering

Alla API-anrop kräver en giltig API-nyckel som skickas med i HTTP-headern. API-åtkomsten är knuten till ditt kundkonto och är i grunden tillgänglig för kundkonton.

info Du behöver ingen separat B2B-ansökan: logga in med ditt kundkonto, öppna API-fliken och generera din API-nyckel där. Till API-åtkomst →

Header-format

HTTP Request Header

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

Exempel 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

Alla endpoints är relativa till följande Base URL:

Base URL

https://artumos.com/api/v1

Alla svar returneras som JSON returneras (Content-Type: application/json).

Rate Limits

Plan	Anrop / minut	Anrop / dag
Kundkonto	60	5.000
Utökad gräns	på begäran	på begäran

Vid överskridande returneras HTTP 429 Too Many Requests returneras. Headern Retry-After innehåller väntetiden i sekunder.

Felkoder

HTTP-Code	Betydelse
`200 OK`	Anropet lyckades
`400 Bad Request`	Ogiltiga parametrar
`401 Unauthorized`	Saknad eller ogiltig API-nyckel
`403 Forbidden`	Ingen behörighet för denna resurs
`404 Not Found`	Resursen hittades inte
`429 Too Many Requests`	Rate Limit överskriden
`500 Internal Server Error`	Serverfel – kontakta supporten

Format för felsvar

JSON

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

Endpoint: Beställningar

GET /api/v1/orders Alla beställningar för kontot

Parameter	Typ	Beskrivning
`page`	integer	Sida (standard: 1)
`per_page`	integer	Poster per sida (max. 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} Hämta enskild beställning

Endpoint: Produkt- och beställningsinformation

GET /api/v1/orders/{order_id}/codes All produktinformation för en beställning

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} Hämta enskild produktinformation

warning Produkt- och beställningsinformation får endast användas inom ramen för respektive beställning och säljaruppgifter. Otillbörlig vidarebefordran kan strida mot användarvillkoren.

Endpoint: Produkter

GET /api/v1/products Hämta produktkatalog

Parameter	Typ	Beskrivning
`category`	string	Filtrera på kategori-slug
`in_stock`	boolean	Endast tillgängliga produkter
`page`	integer	Sida

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 möjligt att ta emot realtidsaviseringar när beställningar eller koder tillhandahålls. Webhook-URL:er kan anges i kundkontot.

Tillgängliga events

Event	Beskrivning
`order.paid`	Beställningen har betalats
`codes.delivered`	Koderna har tillhandahållits
`order.refunded`	Beställningen har återbetalats

Webhook Payload

POST – Din Webhook-endpoint

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

Verifiera signaturen med din Webhook-secret: HMAC-SHA256(payload, webhook_secret)

Vanliga frågor

Vem kan använda B2B API?

Varje kund med kundkonto kan använda API-åtkomsten. Logga in i ditt kundkonto och använd den tillhörande API-nyckeln för autentiserade anrop.

Vilket format har svaren?

Alla svar returneras som JSON. Root-objektet innehåller alltid success: true/false samt antingen data eller error.

Kan jag lägga beställningar via API?

I den första versionen används API:et för att hämta beställningar samt beställnings- och produktinformation. Skrivande beställnings-endpoints aktiveras separat så snart de är tillgängliga.

Finns det en sandbox-miljö?

Ja. Sandlådan kan aktiveras i kundkontot under fliken „API-åtkomst“ och är direkt knuten till respektive API-nyckel.