Documentație B2B

B2B API – preluați automat informații despre comenzi și produse

REST-API-ul nostru este disponibil oricărui client cu cont de client și permite preluarea automată a informațiilor despre comenzi și produse și integrarea lor în propriile sisteme.

vpn_key Deschide accesul API în cont Pagina clienți business

Autentificare

Toate cererile API necesită un API-Key valid, care este trimis în HTTP-Header. Accesul API este legat de contul dvs. de client și este disponibil în principiu conturilor de client.

info Nu aveți nevoie de o cerere B2B separată: conectați-vă cu contul dvs. de client, deschideți tab-ul API și generați acolo API-Key-ul dvs. Către accesul API →

Format Header

HTTP Request Header

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

Exemplu cu 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

Toate endpoint-urile sunt relative la următorul Base URL:

Base URL

https://artumos.com/api/v1

Toate răspunsurile sunt returnate ca JSON (Content-Type: application/json).

Rate Limits

Plan	Cereri / minut	Cereri / zi
Cont de client	60	5.000
Limită extinsă	la cerere	la cerere

La depășire se returnează HTTP 429 Too Many Requests . Header-ul Retry-After conține timpul de așteptare în secunde.

Coduri de eroare

HTTP-Code	Semnificație
`200 OK`	Cerere reușită
`400 Bad Request`	Parametri invalizi
`401 Unauthorized`	API-Key lipsă sau invalid
`403 Forbidden`	Fără permisiune pentru această resursă
`404 Not Found`	Resursă negăsită
`429 Too Many Requests`	Rate Limit depășit
`500 Internal Server Error`	Eroare de server – contactați asistența

Format Response de eroare

JSON

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

Endpoint: Comenzi

GET /api/v1/orders Toate comenzile contului

Parameter	Tip	Descriere
`page`	integer	Pagină (implicit: 1)
`per_page`	integer	Intrări per pagină (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} Preluați o comandă individuală

Endpoint: Informații despre produse și comenzi

GET /api/v1/orders/{order_id}/codes Toate informațiile despre produsele unei comenzi

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} Preluați o informație individuală despre produs

warning Informațiile despre produse și comenzi pot fi utilizate doar în cadrul comenzii respective și al informațiilor despre vânzător. Transmiterea abuzivă poate încălca condițiile de utilizare.

Endpoint: Produse

GET /api/v1/products Preluați catalogul de produse

Parameter	Tip	Descriere
`category`	string	Filtrați după slug de categorie
`in_stock`	boolean	Doar produse disponibile
`page`	integer	Pagină

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

Webhook-urile permit primirea de notificări în timp real atunci când comenzile sau codurile sunt furnizate. URL-urile Webhook pot fi configurate în contul de client.

Evenimente disponibile

Event	Descriere
`order.paid`	Comanda a fost plătită
`codes.delivered`	Codurile au fost furnizate
`order.refunded`	Comanda a fost rambursată

Webhook Payload

POST – Webhook-Endpoint-ul dvs.

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

Verificați semnătura cu Webhook-Secret-ul dvs.: HMAC-SHA256(payload, webhook_secret)

Întrebări frecvente

Cine poate utiliza B2B API?

Orice client cu cont de client poate utiliza accesul API. Conectați-vă în contul dvs. de client și utilizați API-Key-ul aferent pentru cereri autentificate.

Ce format au răspunsurile?

Toate răspunsurile sunt returnate ca JSON. Obiectul Root conține întotdeauna success: true/false precum și fie data fie error.

Pot plasa comenzi prin API?

În prima versiune, API-ul servește la preluarea comenzilor, a informațiilor despre comenzi și produse. Endpoint-urile de scriere a comenzilor vor fi activate separat de îndată ce sunt disponibile.

Există un mediu Sandbox?

Da. Sandbox-ul poate fi activat în contul de client în tab-ul „Acces API” și este legat direct de API-Key-ul respectiv.