API Documentation

Authentication

Our API uses API keys for authentication. Include your API key in the header of every request.

API Key Format

Authorization: Bearer YOUR_API_KEY

Getting Your API Key

Log in to your Jewelry SaaS account
Go to Settings → API Keys
Generate a new API key
Keep your API key secure and never share it publicly

Important: API keys are sensitive information. Never expose them in client-side code or public repositories.

API Endpoints

Products

GET /api/products

Retrieve all products

POST /api/products

Create a new product

PUT /api/products/{id}

Update a product

DELETE /api/products/{id}

Delete a product

Sales

GET /api/sales

Retrieve all sales

POST /api/sales

Create a new sale

GET /api/sales/{id}

Get sale details

Customers

GET /api/customers

Retrieve all customers

POST /api/customers

Create a new customer

Reports

GET /api/reports/sales

Sales report

GET /api/reports/inventory

Inventory report

Code Examples

Create a Product (cURL)

curl -X POST "https://api.jewelrysaas.com/api/products" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Gold Ring",
    "category": "Rings",
    "weight": 5.2,
    "purity": "22K",
    "price": 25000,
    "stock_quantity": 10
  }'
                    

Get Products (JavaScript)

const response = await fetch('https://api.jewelrysaas.com/api/products', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});

const products = await response.json();
console.log(products);
                    

Create a Sale (Python)

import requests

url = "https://api.jewelrysaas.com/api/sales"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}

data = {
    "customer_id": 123,
    "items": [
        {
            "product_id": 456,
            "quantity": 1,
            "price": 25000
        }
    ],
    "payment_method": "cash"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())
                    

SDK & Libraries

We provide official SDKs for popular programming languages to make integration easier.

JavaScript/Node.js

npm install jewelry-saas-sdk

Python

pip install jewelry-saas

PHP

composer require jewelry/saas-sdk

API Support

Need Help?

Our API support team is here to help you integrate successfully.

WhatsApp: +91 74300 10676
Email: info@claban.in
Website: claban.in

Rate Limits

Free Plan: 100 requests/hour
Premium Plan: 1000 requests/hour
Enterprise: Unlimited requests

Rate limits are per API key. Contact us for higher limits.

Quick Navigation