নিজের ওয়েবসাইট কানেক্ট করা (API ও ওয়েবহুক)

composer require omniconva/laravel
php artisan omniconva:install
php artisan migrate

class Products extends EloquentProductSource
{
    public function query(): Builder
    {
        return Product::query()->with(['variants', 'images']);
    }

    public function map(Model $product): ProductData
    {
        return ProductData::make($product->id, $product->name)
            ->url(route('products.show', $product))
            ->price($product->price)
            ->salePrice($product->sale_price)
            ->stockQuantity($product->stock)
            ->images($product->images->pluck('url'))
            ->variants($product->variants->map(
                fn ($v) => VariantData::make($v->id, $v->name)
                    ->price($v->price)
                    ->stockQuantity($v->stock)
                    ->options(['Size' => $v->size])
            ));
    }
}

class Orders implements OrderHandler
{
    public function createOrder(OrderData $order): OrderResult
    {
        $saved = Order::create([
            'customer_name' => $order->customer->name,
            'phone' => $order->customer->phone,
            'address' => $order->shippingAddress->address,
            'total' => $order->total,
        ]);

        return OrderResult::make($saved->id, $saved->number);
    }
}

import express from 'express';
import { createOmniConva } from '@omniconva/node';

const omniconva = createOmniConva({
  products: {
    async list({ page, perPage }) {
      const { rows, total } = await db.products.page(page, perPage);
      return { products: rows.map(toOmniConva), total };
    },
    async get(id) {
      const row = await db.products.find(id);
      return row ? toOmniConva(row) : null;
    },
  },
  orders: {
    async create(order) {
      const saved = await db.orders.create(order);
      return { orderId: saved.id, orderNumber: saved.number };
    },
  },
});

const app = express();
app.use(omniconva.express()); // before express.json()

// after saving a product
await omniconva.productUpdated(toOmniConva(product));

GET https://yourwebsite.com/api/products?page=1&per_page=50
Authorization: Bearer <your products API token>

{
  "products": [
    {
      "id": "1001",
      "title": "Hero Hoodie",
      "url": "https://yourwebsite.com/products/hero-hoodie",
      "description": "<p>Warm fleece hoodie.</p>",
      "short_description": "Warm fleece hoodie.",
      "status": "active",
      "sku": "HOODIE",
      "brand": "Hero",
      "categories": [
        "Hoodies"
      ],
      "tags": [
        "fleece"
      ],
      "images": [
        "https://cdn.yourwebsite.com/hoodie.jpg"
      ],
      "currency": "BDT",
      "price": "1500.00",
      "sale_price": "1200.00",
      "in_stock": true,
      "stock_quantity": 7,
      "variants": [
        {
          "id": "1001-M",
          "title": "M",
          "sku": "HOODIE-M",
          "price": "1500.00",
          "sale_price": "1200.00",
          "in_stock": true,
          "stock_quantity": 7,
          "image": null,
          "options": {
            "Size": "M"
          }
        }
      ],
      "updated_at": "2026-10-01T10:00:00Z"
    }
  ],
  "page": 1,
  "per_page": 50,
  "total": 128,
  "has_more": true
}

POST https://api.omniconva.com/webhooks/custom-website/<store id>
Authorization: Bearer <webhook token>
X-Webhook-Topic: product.updated
Content-Type: application/json

// Node.js: sign the exact body you send.
const crypto = require("crypto");
const body = JSON.stringify(payload);
const t = Math.floor(Date.now() / 1000);
const v1 = crypto
  .createHmac("sha256", SIGNING_SECRET)
  .update(`${t}.${body}`)
  .digest("hex");

await fetch(WEBHOOK_URL, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${WEBHOOK_TOKEN}`,
    "X-Webhook-Topic": "product.updated",
    "X-OmniConva-Signature": `t=${t},v1=${v1}`,
  },
  body,
});

POST https://yourwebsite.com/api/orders
Authorization: Bearer <your order API token>
Content-Type: application/json
Idempotency-Key: <OmniConva order id>

{
  "id": "6a3f0c1e-2b7d-4c1a-9f3e-8d2b1c0a9e77",
  "order_number": "1042",
  "source": "omniconva",
  "currency": "BDT",
  "customer": {
    "name": "Rahim Uddin",
    "phone": "01711000000"
  },
  "shipping_address": {
    "address": "House 12, Road 4, Dhanmondi",
    "city": "Dhaka",
    "state": null,
    "postcode": null,
    "country": "BD"
  },
  "items": [
    {
      "product_id": "1001",
      "variant_id": "1001-M",
      "sku": "HOODIE-M",
      "title": "Hero Hoodie – M",
      "quantity": 2,
      "unit_price": "1200.00",
      "total": "2400.00",
      "image": "https://cdn.yourwebsite.com/hoodie.jpg"
    }
  ],
  "subtotal": "2400.00",
  "discount": "0.00",
  "shipping": {
    "title": "Inside Dhaka",
    "amount": "60.00"
  },
  "fees": [],
  "total": "2460.00",
  "payment": {
    "method": "cash_on_delivery",
    "status": "unpaid"
  },
  "note": "Placed through OmniConva chat, cash on delivery."
}

{
  "order_id": "W-5531",
  "order_number": "5531"
}

GET https://yourwebsite.com/api/products/{id}

{
  "order_id": "W-5531",
  "status": "shipped",
  "tracking": {
    "number": "TRK123",
    "carrier": "Pathao",
    "url": "https://track.example.com/TRK123"
  },
  "note": "Rider assigned",
  "updated_at": "2026-10-10T10:00:00Z"
}

{
  "metadata": {
    "total": 128,
    "page": 1,
    "per_page": 50
  },
  "products": [
    {
      "id": 6001,
      "title": "Classic Cotton T-Shirt",
      "url": "https://yourwebsite.com/products/classic-cotton-tshirt",
      "description": "<p>Premium organic cotton t-shirt.</p>",
      "summary": "Premium organic cotton t-shirt.",
      "published": true,
      "is_draft": false,
      "purchasable": true,
      "sku": "TSHIRT-CLASSIC",
      "brand": "EcoWear",
      "tags": [
        "cotton"
      ],
      "categories": [
        {
          "id": 20,
          "title": "Shirts",
          "slug": "shirts"
        }
      ],
      "images": [
        {
          "url": "https://cdn.yourwebsite.com/tshirt.jpg"
        }
      ],
      "pricing": {
        "regular_price": "24.99",
        "sale_prices": []
      },
      "inventory": {
        "stock_status": true,
        "stocks": []
      },
      "variations": [
        {
          "id": 6002,
          "title": "Small / Red",
          "sku": "TSHIRT-S-RED",
          "published": true,
          "pricing": {
            "regular_price": "24.99",
            "sale_prices": []
          },
          "inventory": {
            "stock_status": true,
            "stocks": [
              {
                "quantity": 50
              }
            ]
          },
          "images": [],
          "attributes": [
            {
              "id": 5,
              "name": "Size",
              "value": "Small"
            },
            {
              "id": 6,
              "name": "Color",
              "value": "Red"
            }
          ]
        }
      ],
      "updated_at": "2026-02-25T16:30:00"
    }
  ]
}

{
  "id": 1042,
  "deliveryCharge": "60",
  "contact": {
    "name": "Customer Name",
    "phone": "01700000000",
    "address": "House 12, Road 4, Dhanmondi, Dhaka"
  },
  "total_price": 1258,
  "note": "Placed through OmniConva chat, cash on delivery.",
  "payment_method": "cash_on_delivery",
  "payment_status": "unpaid",
  "line_items": [
    {
      "product_id": "6001",
      "sku": "TSHIRT-S-RED",
      "variation_id": "6002",
      "name": "Classic Cotton T-Shirt – Small / Red",
      "price": 599,
      "quantity": 2,
      "image": "https://cdn.yourwebsite.com/tshirt.jpg"
    }
  ],
  "omniconva_order_id": "6a3f0c1e-2b7d-4c1a-9f3e-8d2b1c0a9e77",
  "city": "Dhaka",
  "discount": 0
}