B2B dokumentáció

B2B API – rendelési és termékinformációk automatizált lekérése

REST API-nk minden ügyfélfiókkal rendelkező ügyfél rendelkezésére áll, és lehetővé teszi a rendelési és termékinformációk automatizált lekérését és saját rendszerekbe való integrálását.

vpn_key API-hozzáférés megnyitása a fiókban Üzleti ügyfelek oldala

Hitelesítés

Minden API-kérés érvényes API-kulcsot igényel, amelyet a HTTP-fejlécben kell elküldeni. Az API-hozzáférés az ügyfélfiókodhoz van kötve, és alapvetően az ügyfélfiókok rendelkezésére áll.

info Nincs szükség külön B2B-kérelemre: jelentkezzen be ügyfélfiókjával, nyissa meg az API-fület, és ott generálja az API-kulcsát. Az API-hozzáféréshez →

Fejlécformátum

HTTP Request Header

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

Példa cURL-lel

cURL

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

Base URL

Minden végpont a következő Base URL-hez viszonyítva relatív:

Base URL

https://artumos.com/api/v1

Minden válasz JSON formátumban kerül visszaadásra (Content-Type: application/json).

Rate Limits

Plan	Kérés / perc	Kérés / nap
Ügyfélfiók	60	5.000
Bővített limit	kérésre	kérésre

Túllépés esetén HTTP 429 Too Many Requests kerül visszaadásra. A fejléc Retry-After tartalmazza a várakozási időt másodpercben.

Hibakódok

HTTP-Code	Jelentés
`200 OK`	A kérés sikeres
`400 Bad Request`	Érvénytelen paraméterek
`401 Unauthorized`	Hiányzó vagy érvénytelen API-kulcs
`403 Forbidden`	Nincs jogosultság ehhez az erőforráshoz
`404 Not Found`	Az erőforrás nem található
`429 Too Many Requests`	Rate Limit túllépve
`500 Internal Server Error`	Szerverhiba – kérjük, lépjen kapcsolatba a támogatással

Hiba-válasz formátum

JSON

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

Végpont: rendelések

GET /api/v1/orders A fiók összes rendelése

Parameter	Típus	Leírás
`page`	integer	Oldal (alapértelmezett: 1)
`per_page`	integer	Bejegyzés oldalanként (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} Egyetlen rendelés lekérése

Végpont: termék- és rendelési információk

GET /api/v1/orders/{order_id}/codes Egy rendelés összes termékinformációja

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} Egyetlen termékinformáció lekérése

warning A termék- és rendelési információk csak az adott rendelés és az eladói adatok keretében használhatók fel. A visszaélésszerű továbbadás sértheti a felhasználási feltételeket.

Végpont: termékek

GET /api/v1/products Termékkatalógus lekérése

Parameter	Típus	Leírás
`category`	string	Kategória-slug szerinti szűrés
`in_stock`	boolean	Csak elérhető termékek
`page`	integer	Oldal

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

A webhookok lehetővé teszik valós idejű értesítések fogadását, amikor rendeléseket vagy kódokat biztosítanak. A Webhook-URL-ek az ügyfélfiókban tárolhatók.

Elérhető események

Event	Leírás
`order.paid`	A rendelés kifizetésre került
`codes.delivered`	A kódok biztosításra kerültek
`order.refunded`	A rendelés visszatérítésre került

Webhook Payload

POST – Az Ön Webhook-végpontja

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

Ellenőrizze az aláírást a Webhook-Secret segítségével: HMAC-SHA256(payload, webhook_secret)

Gyakori kérdések

Ki használhatja a B2B API-t?

Minden ügyfélfiókkal rendelkező ügyfél használhatja az API-hozzáférést. Jelentkezzen be ügyfélfiókjába, és használja a hozzá tartozó API-kulcsot a hitelesített kérésekhez.

Milyen formátumúak a válaszok?

Minden válasz JSON formátumban kerül visszaadásra. A gyökérobjektum mindig tartalmazza a success: true/false mezőt, valamint vagy a data vagy a error.

Leadhatok rendeléseket az API-n keresztül?

Az első verzióban az API a rendelések, rendelési és termékinformációk lekérésére szolgál. Az írási rendelési végpontok külön kerülnek engedélyezésre, amint elérhetővé válnak.

Van sandbox-környezet?

Igen. A sandbox az ügyfélfiókban az „API-hozzáférés” fülön aktiválható, és közvetlenül az adott API-kulcshoz van kötve.