API & Developer

REST API za vas webshop

Integrirajte ShopKit s bilo kojim sustavom putem naseg REST API-ja. JSON format, OAuth 2.0 autentifikacija, webhooks i SDK-ovi.

Enterprise+ paket — kontaktirajte nas
Započnite besplatno Pogledajte demo

API pregled

Sve sto trebate za integraciju s vasim sustavima.

REST JSON API

Standardni REST API s JSON request/response formatom. Intuitivni endpointi, paginacija, filtriranje i sortiranje.

OAuth 2.0 autentifikacija

Sigurna autentifikacija putem API kljuceva ili OAuth 2.0 tokena. Granularna kontrola permisija po kljucu.

Verzioniranje API-ja

Podrška za više verzija API-ja (v1, v2). Backward compatibility i deprecation notices za lakšu migraciju.

Rate limiting

1000 zahtjeva po minuti za stabilnost. Retry-After headeri za graceful handling. Vise limiti za Enterprise.

Sandbox okruženje

Potpuno testno okruženje s mock podacima. Testirajte integraciju bez utjecaja na produkcijske podatke.

Opsežna dokumentacija

Interaktivna API dokumentacija s primjerima, try-it-out suceljem i code snippetima za svaki endpoint.

API endpointi

Potpuni pristup svim resursima vaseg webshopa.

Proizvodi

CRUD operacije za proizvode. Varijante, atributi, slike, cijene, zalihe, SEO meta podaci.

GET POST PUT DELETE

Kategorije

Hijerarhijsko upravljanje kategorijama. Kreiranje, uređivanje, brisanje, premjestanje.

GET POST PUT DELETE

Narudzbe

Pregled, kreiranje i azuriranje narudžbi. Stavke, statusi, plaćanja, dostava.

GET POST PUT

Kupci

Upravljanje kupcima. Registracija, adrese, povijest narudžbi, segmentacija.

GET POST PUT DELETE

Zalihe

Upravljanje zalihama po proizvodu i varijanti. Bulk azuriranje, low stock obavijesti.

GET PUT

Dostava

Zone dostave, carrier integracije, kreiranje paketa, tracking.

GET POST PUT

Webhooks — real-time obavijesti

Primajte instant obavijesti o događajima u vašem webshopu. Konfigurirajte URL-ove iz admin panela.

order.created

Aktivira se kad kupac zavrsi narudžbu. Sadrzi kompletne podatke o narudžbi, stavkama i kupcu.

payment.received

Aktivira se kad se uplata uspjesno procesira. Stripe, CorvusPay ili bankovna uplata.

order.status_changed

Aktivira se pri svakoj promjeni statusa narudžbe: obrada, otprema, isporuka, storno.

stock.updated

Aktivira se kad se promijene zalihe proizvoda. Low stock alert i out-of-stock obavijesti.

customer.created

Aktivira se pri registraciji novog kupca. Sinkronizacija s CRM ili email marketing sustavom.

product.updated

Aktivira se pri promjeni proizvoda. Cijena, opis, zalihe, status — svaka promjena salje webhook.

Primjer API poziva

Jednostavan i intuitivan API. Evo kako dohvatiti proizvode:

GET Dohvati listu proizvoda 
curl -X GET "https://vas-shop.shopkit.hr/api/v1/products" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json"
Response (200 OK): 
{
  "data": [
    {
      "id": 1,
      "name": "Majica Premium Cotton",
      "slug": "majica-premium-cotton",
      "price": 29.99,
      "currency": "EUR",
      "stock": 150,
      "status": "active",
      "categories": ["odjeca", "majice"],
      "images": [
        "https://vas-shop.shopkit.hr/storage/products/majica-1.webp"
      ]
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 25,
    "total": 142
  }
}

Službeni SDK-ovi

Koristite nase SDK-ove za brzu integraciju u vašem omiljenom jeziku.

PHP SDK

Composer paket za PHP 8.1+

composer require shopkit/php-sdk

JavaScript SDK

NPM paket za Node.js i browser

npm install @shopkit/js-sdk

Izgradite nesto sjajno

REST API, webhooks i SDK-ovi dostupni u Enterprise+ planu. Sandbox okruženje za testiranje bez rizika.

Započnite besplatno Kontaktirajte nas

API i webhooks ekskluzivno za Enterprise+ plan. Sandbox dostupan odmah po registraciji.