ডেভেলপার API ও ইন্টিগ্রেশন নির্দেশিকা Developer API & Integration Guide

curl -X GET "https://stockwhisk.com/api/integrations/webhooks/YOUR_ENDPOINT_UUID/?sku=GDO-273540" \
  -H "X-Webhook-Secret: whsec_YOUR_SECRET_TOKEN"

// Next.js Route Handler / Node.js
export async function checkProductStock(sku) {
  const endpoint = process.env.STOCKWHISK_WEBHOOK_URL;
  const secret = process.env.STOCKWHISK_SECRET_TOKEN;

  const res = await fetch(`${endpoint}?sku=${encodeURIComponent(sku)}`, {
    method: "GET",
    headers: {
      "X-Webhook-Secret": secret,
    },
    cache: "no-store", // Ensure real-time query
  });

  if (!res.ok) throw new Error("Stock query failed");
  const data = await res.json();
  
  // Returns: { id, name, sku, selling_price, on_hand, reserved, available, in_stock }
  return data;
}

// PHP / Laravel Http Client
use Illuminate\Support\Facades\Http;

function getStockWhiskAvailability($sku) {
    $response = Http::withHeaders([
        'X-Webhook-Secret' => config('services.stockwhisk.secret'),
    ])->get(config('services.stockwhisk.webhook_url'), [
        'sku' => $sku,
    ]);

    if ($response->successful()) {
        $item = $response->json();
        return $item['available'] > 0;
    }
    return false;
}

# Python (Requests / FastAPI / Django)
import requests

def check_stock(sku: str) -> dict:
    url = "https://stockwhisk.com/api/integrations/webhooks/YOUR_ENDPOINT_UUID/"
    headers = {"X-Webhook-Secret": "whsec_YOUR_SECRET_TOKEN"}
    
    response = requests.get(url, params={"sku": sku}, headers=headers, timeout=5)
    response.raise_for_status()
    return response.json()

{
  "event": "order.created",
  "id": "WEB-ORD-9005",
  "order_number": "9005",
  "total": 1450.00,
  "customer": {
    "name": "Mahmudul Hasan",
    "phone": "01819998877",
    "address": "House 12, Road 4, Banani, Dhaka"
  },
  "items": [
    {
      "sku": "GDO-273540",
      "quantity": 1,
      "unit_price": 1450.00
    }
  ]
}

curl -X POST "https://stockwhisk.com/api/integrations/webhooks/YOUR_ENDPOINT_UUID/?sync=true" \
  -H "X-Webhook-Secret: whsec_YOUR_SECRET_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "event": "order.created",
    "id": "WEB-ORD-9005",
    "order_number": "9005",
    "total": 1450.00,
    "customer": {
      "name": "Mahmudul Hasan",
      "phone": "01819998877",
      "address": "House 12, Road 4, Banani, Dhaka"
    },
    "items": [
      {
        "sku": "GDO-273540",
        "quantity": 1,
        "unit_price": 1450.00
      }
    ]
  }'

// Next.js / Node.js Checkout Completion Handler
export async function pushOrderToStockWhisk(order) {
  const endpoint = `${process.env.STOCKWHISK_WEBHOOK_URL}?sync=true`;
  const secret = process.env.STOCKWHISK_SECRET_TOKEN;

  const payload = {
    event: "order.created",
    id: String(order.id),
    order_number: String(order.orderNumber),
    total: Number(order.totalAmount),
    customer: {
      name: order.customerName,
      phone: order.customerPhone,
      address: order.shippingAddress,
    },
    items: order.lineItems.map(item => ({
      sku: item.sku,
      quantity: Number(item.qty),
      unit_price: Number(item.price),
    })),
  };

  const res = await fetch(endpoint, {
    method: "POST",
    headers: {
      "X-Webhook-Secret": secret,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(payload),
  });

  const data = await res.json();
  if (!res.ok) {
    throw new Error(data.error || "Order placement failed");
  }

  // data = { status: "success", invoice_no: "INV-000005", sale_id: 215, ... }
  return data;
}

// Laravel Controller or Order Observer
use Illuminate\Support\Facades\Http;

public function handleOrderPlaced($order) {
    $webhookUrl = config('services.stockwhisk.url') . '?sync=true';
    $secret = config('services.stockwhisk.secret');

    $response = Http::withHeaders([
        'X-Webhook-Secret' => $secret,
        'Content-Type' => 'application/json',
    ])->post($webhookUrl, [
        'event' => 'order.created',
        'id' => (string) $order->id,
        'order_number' => $order->order_number,
        'total' => (float) $order->total,
        'customer' => [
            'name' => $order->shipping_name,
            'phone' => $order->billing_phone,
            'address' => $order->shipping_address,
        ],
        'items' => collect($order->items)->map(fn($item) => [
            'sku' => $item->sku,
            'quantity' => $item->quantity,
            'unit_price' => $item->price,
        ])->toArray(),
    ]);

    if ($response->successful()) {
        $result = $response->json();
        // Save StockWhisk invoice number to local order record
        $order->update(['stockwhisk_invoice' => $result['invoice_no']]);
    }
}