Authenticate using JSON Web Tokens issued by the Token endpoints.

Copy{
  "username": "demo",
  "password": "••••••••"
}

Copy// Response
{
  "access": "eyJhbGciOi...",
  "refresh": "eyJ0eXAiOi..."
}

Copy{
  "refresh": "<refresh_token>"
}

Use in Requests

Copycurl -H "Authorization: Bearer <access_token>" \
  bas_url/api/v1/products/

Currency

Returns a json list of currencies with their respective flags in encoded format. Display on html page for visibility of flags.

Copyfetch("https://nexus.smartstock.africa/currency/",{headers: {Authorization: "Bearer access_token"}})"

Copy{
  "count": 224,
  "next": "bas_url/currency/?page=2",
  "previous": null,
  "results": [
    {"id":1,"currencyCode":"AFN","flag_emoji":"🇦🇫"}
  ]
}

Products

Returns a paginated list of products.

Copycurl -H "Authorization: Bearer <token>" \
bas_url/api/v1/products/?page=1&page_size=20

Copy{
  "count": 42,
  "next": "bas_url/api/v1/products/?page=2",
  "previous": null,
  "results": [
    {"id":1,"name":"Laptop","price":"1200.00","currency":"USD"}
  ]
}

Copycurl -X POST \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"name":"Mouse","price":"19.99","currency":"USD"}' \
  bas_url/api/v1/products/

Smartstock uses standard DRF pagination with count, next, previous, and results fields. You can override the page size using ?page_size= (max 100).

Example policy (configure in DRF):

Register a webhook endpoint to receive Smartstock events.

CopyPOST https://yourapp.com/webhooks/smartstock
Headers:  Smartstock-Signature: t=..., v1=...
Body:     {"id":1,"name":"Laptop", ...}

• v1.1 — Change limits for anonymous users and authenticated users.

• v1.0 — Initial release: JWT auth, Products CRUD, pagination.