B2B dokumentacija

B2B API – automatsko preuzimanje informacija o porudžbinama i proizvodima

Naš REST API je dostupan svakom klijentu sa korisničkim nalogom i omogućava automatsko preuzimanje informacija o porudžbinama i proizvodima i njihovu integraciju u sopstvene sisteme.

vpn_key Otvori API pristup u nalogu Stranica za poslovne klijente

Autentifikacija

Svi API zahtevi zahtevaju važeći API-Key, koji se šalje u HTTP zaglavlju. API pristup je vezan za vaš korisnički nalog i u principu je dostupan korisničkim nalozima.

info Nije vam potreban poseban B2B zahtev: prijavite se sa svojim korisničkim nalogom, otvorite API tab i tu generišite svoj API-Key. Ka API pristupu →

Format zaglavlja

HTTP Request Header

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

Primer sa 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

Svi endpoint-i su relativni u odnosu na sledeći Base URL:

Base URL

https://artumos.com/api/v1

Svi odgovori se vraćaju kao JSON (Content-Type: application/json).

Rate Limits

Plan	zahteva / minut	zahteva / dan
Korisnički nalog	60	5.000
Prošireni limit	na upit	na upit

Pri prekoračenju se vraća HTTP 429 Too Many Requests . Zaglavlje Retry-After sadrži vreme čekanja u sekundama.

Kodovi grešaka

HTTP-Code	Značenje
`200 OK`	Zahtev uspešan
`400 Bad Request`	Nevažeći parametri
`401 Unauthorized`	Nedostajući ili nevažeći API-Key
`403 Forbidden`	Nema dozvole za ovaj resurs
`404 Not Found`	Resurs nije pronađen
`429 Too Many Requests`	Rate Limit prekoračen
`500 Internal Server Error`	Greška servera – molimo kontaktirajte support

Format odgovora na grešku

JSON

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

Endpoint: Porudžbine

GET /api/v1/orders Sve porudžbine naloga

Parameter	Tip	Opis
`page`	integer	Stranica (podrazumevano: 1)
`per_page`	integer	Unosa po stranici (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} Preuzimanje pojedinačne porudžbine

Endpoint: Informacije o proizvodu i porudžbini

GET /api/v1/orders/{order_id}/codes Sve informacije o proizvodu jedne porudžbine

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} Preuzimanje pojedinačne informacije o proizvodu

warning Informacije o proizvodu i porudžbini smeju se koristiti samo u okviru odgovarajuće porudžbine i podataka prodavca. Zloupotrebno prosleđivanje može da prekrši uslove korišćenja.

Endpoint: Proizvodi

GET /api/v1/products Preuzimanje kataloga proizvoda

Parameter	Tip	Opis
`category`	string	Filtriraj po slug-u kategorije
`in_stock`	boolean	Samo dostupni proizvodi
`page`	integer	Stranica

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-ovi omogućavaju primanje obaveštenja u realnom vremenu kada se porudžbine ili kodovi obezbede. Webhook URL-ovi se mogu sačuvati u korisničkom nalogu.

Dostupni Events

Event	Opis
`order.paid`	Porudžbina je plaćena
`codes.delivered`	Kodovi su obezbeđeni
`order.refunded`	Porudžbina je refundirana

Webhook Payload

POST – Vaš Webhook-Endpoint

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

Verifikujte potpis svojim Webhook-Secret-om: HMAC-SHA256(payload, webhook_secret)

Česta pitanja

Ko može da koristi B2B API?

Svaki klijent sa korisničkim nalogom može da koristi API pristup. Prijavite se u svoj korisnički nalog i koristite pripadajući API-Key za autentifikovane zahteve.

Koji format imaju odgovori?

Svi odgovori se vraćaju kao JSON. Root objekat uvek sadrži success: true/false kao i ili data ili error.

Mogu li da naručujem putem API?

U prvoj verziji API služi za preuzimanje porudžbina, informacija o porudžbinama i proizvodima. Endpoint-i za upisivanje porudžbina biće zasebno omogućeni čim budu dostupni.

Postoji li Sandbox okruženje?

Da. Sandbox se može aktivirati u korisničkom nalogu u tabu „API pristup“ i direktno je vezan za odgovarajući API-Key.