API & Webhooks

REST API v1. 23 endpoint-uri.
Făcută pentru dev-i.

Autentificare simplă, request logging complet, webhooks pentru ingestie. Conectezi ERP, custom dashboard, n8n sau Zapier fără să rogi pe cineva.

Documentație completă

Autentificare

Bearer token cu format <tenant-slug>.<key>. Generezi chei din Settings → API Keys. Fiecare cheie poate avea permisiuni opționale (read-only, write, full).

curl

Exemplu request

# Listă comenzi în procesare, ultimele 25
curl -X GET \
  "https://api.notsowms.ro/v1/orders?status=processing&limit=25" \
  -H "Authorization: Bearer wartung.sk_live_aBc123XyZ" \
  -H "Accept: application/json"

Endpoint-uri

Douăzeci și trei de endpoint-uri acoperă ciclul complet. Toate returnează JSON, toate paginate unde e relevant, toate rate-limited transparent.

GET/v1/productsListă produse (paginat, filtrabil)

GET/v1/products/{id}Detalii produs

POST/v1/productsCreare produs

PUT/v1/products/{id}Actualizare produs

DELETE/v1/products/{id}Ștergere produs

GET/v1/ordersListă comenzi (filtrabil după status, dată, client)

GET/v1/orders/{id}Detalii comandă cu line items

POST/v1/ordersCreare comandă

PUT/v1/orders/{id}/statusSchimbare status comandă

DELETE/v1/orders/{id}Anulare comandă

GET/v1/inventoryStoc curent pe toate locațiile

GET/v1/inventory/summaryRezumat agregat pe SKU

POST/v1/inventory/add-stockAdaugă stoc la o locație

POST/v1/inventory/remove-stockScade stoc dintr-o locație

GET/v1/sellersListă furnizori

POST/v1/sellersCreare furnizor

PUT/v1/sellers/{id}Actualizare furnizor

DELETE/v1/sellers/{id}Ștergere furnizor

GET/v1/locationsListă locații (read-only)

POST/v1/webhooks/orderWebhook inbound: comandă nouă

POST/v1/webhooks/status-updateWebhook inbound: update status

Request logging

Fiecare request e logat: method, endpoint, IP, user agent, status, response time. Debugging transparent.

Rotație de chei

Generezi și revoci chei oricând. Pentru chei scurse, revocarea e instantanee, fără downtime.

Rate limiting

Throttle configurabil. 60 req/min default pe cheie, ridicabil pentru Enterprise.

Webhook-uri inbound: Dacă vrei să împingi comenzi sau update-uri din sistemul tău, folosești POST /v1/webhooks/order sau POST /v1/webhooks/status-update. Semnătură HMAC opțională pentru verificare.

Vrei să testezi API-ul?

Contul de trial include acces complet la API. Primești un tenant sandbox cu date de exemplu și o cheie de test.

Cere acces API