من صفر إلى أول طلب في 10 دقائق

export VIA_API_KEY="sk_test_…"

curl https://sandbox.api.via-basket.com/v1/orders \
  -H "Authorization: Bearer $VIA_API_KEY"

{
  "data": [
    {
      "id": "ord_01H9F…",
      "store_id": "store_01H…",
      "status": "created",
      "total_amount": "125.00",
      "currency": "AED",
      "created_at": "2026-04-17T09:12:30Z"
    }
  ],
  "cursor": null
}

curl -X POST https://sandbox.api.via-basket.com/v1/orders \
  -H "Authorization: Bearer $VIA_API_KEY" \
  -H "Idempotency-Key: order-abc-123" \
  -H "Content-Type: application/json" \
  -d '{
    "store_id": "store_01H...",
    "items": [{"sku": "BRD-001", "qty": 2}],
    "delivery": {"lat": 30.0444, "lng": 31.2357}
  }'

curl -X POST https://sandbox.api.via-basket.com/v1/webhooks \
  -H "Authorization: Bearer $VIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/hooks/via",
    "events": ["order.created", "order.status_changed", "order.delivered"],
    "description": "Production dispatch integration"
  }'

import express from 'express';
import { verifySignature } from '@via/sdk';

const app = express();

app.post(
    '/hooks/via',
    express.raw({ type: 'application/json' }),  // raw body is load-bearing
    (req, res) => {
        const sig = req.header('X-VIA-Signature') ?? '';
        if (!verifySignature(req.body, sig, process.env.VIA_WEBHOOK_SECRET!)) {
            return res.status(400).end();
        }
        const event = JSON.parse(req.body.toString());
        // …fulfil event…
        res.status(204).end();
    },
);