API Reference

All endpoints available to external apps

Base URL

https://api.fez.sa/v1

Authentication

curl https://api.fez.sa/v1/products \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json"

# Response
{
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150
  }
}

Endpoints

Method	Endpoint	Scope	Description
GET	/api/v1/store	read_store	Store info, settings
GET	/api/v1/products	read_products	List products with filters
GET	/api/v1/products/:id	read_products	Product details + variants
POST	/api/v1/products	write_products	Create product
PUT	/api/v1/products/:id	write_products	Update product
GET	/api/v1/orders	read_orders	List orders with pagination
GET	/api/v1/orders/:id	read_orders	Order details + items
PUT	/api/v1/orders/:id/status	write_orders	Update order status
GET	/api/v1/customers	read_customers	List customers
GET	/api/v1/customers/:id	read_customers	Customer details
GET	/api/v1/categories	read_products	Category tree
GET	/api/v1/inventory	read_products	Inventory levels

⚡ Rate Limits

100 requests/minute per app. Limits returned in X-RateLimit-* headers.