Rock Wood API

RESTful API endpoints for integrating with our industrial, mining and farming products system

API Overview

Our API provides comprehensive access to product information, user management, and analytics data. All endpoints return JSON responses and support standard HTTP methods.

Base URL
http://127.0.0.1:8000/api/
Authentication

Most endpoints require JWT authentication. Include the token in the Authorization header:

Authorization: Bearer <your-token>

Available Endpoints

Authentication

  • POST /api/auth/login/ - User login
  • POST /api/auth/logout/ - User logout
  • POST /api/auth/register/ - User registration
  • GET /api/auth/verify/ - Token verification
  • POST /api/auth/refresh/ - Token refresh
  • GET /api/auth/users/ - User management

Products

  • GET /api/products/ - List products (admin)
  • POST /api/products/ - Create product (admin)
  • GET /api/products/{id}/ - Product details
  • PUT /api/products/{id}/ - Update product (admin)
  • DELETE /api/products/{id}/ - Delete product (admin)
  • GET /api/products/categories/ - List categories

Public Catalogue

  • GET /api/catalogue/products/ - Public product list
  • GET /api/catalogue/products/{id}/ - Public product details
  • GET /api/catalogue/categories/ - Public category list
  • GET /api/catalogue/categories/{id}/ - Public category details

Admin Dashboard

  • GET /api/admin/dashboard/ - Dashboard overview
  • GET /api/admin/users/ - User management
  • GET /api/admin/products/ - Product administration
  • GET /api/admin/categories/ - Category management
  • GET /api/admin/analytics/ - Analytics data

Analytics

  • POST /api/analytics/track/ - Track user events
  • GET /api/analytics/fingerprint/ - Get visitor fingerprint
  • GET /api/analytics/stats/ - Analytics statistics
  • GET /api/analytics/events/ - Usage events
  • GET /api/analytics/sessions/ - Session data
  • GET /api/analytics/fingerprints/ - Fingerprint data

System Info

  • GET /api/ - API root with endpoint overview
  • GET / - Home page
  • GET /about/ - About page
  • GET /contact/ - Contact page

Example Usage

Get Public Products

curl -X GET http://127.0.0.1:8000/api/catalogue/products/

Login

curl -X POST http://127.0.0.1:8000/api/auth/login/ \
  -H "Content-Type: application/json" \
  -d '{"email": "admin@rockwood.com", "password": "admin123"}'

Get Products (Authenticated)

curl -X GET http://127.0.0.1:8000/api/products/ \
  -H "Authorization: Bearer <your-token>"

Ready to Get Started?

Explore our API and integrate with our industrial, mining and farming products system

API Root View Products