توسعه‌دهندگان — StoreBridge

احراز هویت

دانلود پلاگین: عمومی و بدون نیاز به احراز هویت — هر بار build تازه، همراه با چک‌سام SHA-256.

سفارش‌ها و اتصال OAuth ووکامرس: Seller Access Token سلفی (Bearer) — از پنل فروشنده، System ← API Access Tokens صادر می‌شود؛ اعتبار یک‌ساله و قابل ابطال فوری.

دریافت وب‌هوک (ووکامرس و SDK): بدون نیاز به توکن، اما هر درخواست با امضای HMAC-SHA256 روی بدنه خام و کلید مخصوص همان سایت تأیید می‌شود.

رویدادهای Real-time (SSE): کلید API مخصوص StoreBridge (sb_...) به‌صورت Bearer، به‌همراه بررسی Origin.

گروه‌های Endpoint

GET /api/v1/storebridge/plugin/woocommerce — عمومی — متادیتای آخرین نسخهٔ پلاگین.

GET /api/v1/storebridge/plugin/woocommerce/download — عمومی — دانلود فایل zip پلاگین.

GET /api/v1/sites/{siteId}/orders — Seller Access Token — فهرست سفارش‌های سینک‌شده از فروشگاه خارجی.

GET /api/v1/sites/{siteId}/orders/{orderId} — Seller Access Token — جزئیات یک سفارش، شامل استردادها.

POST /api/v1/sites/{siteId}/orders/{orderId}/cancel — Seller Access Token — درخواست لغو سفارش.

GET|POST /api/v1/oauth/woocommerce/connect|callback|refresh — Seller Access Token — جریان اتصال کلید REST API ووکامرس.

POST /api/v1/webhooks/woocommerce/{siteId} — امضای HMAC — دریافت رویداد بومی ووکامرس (محصول/سفارش).

POST /api/v1/webhooks/sdk/{siteId} — امضای HMAC — دریافت رویداد از SDK جاوااسکریپت جاسازی‌شده.

GET /api/v1/sites/{siteId}/events — کلید StoreBridge (sb_...) — استریم رویداد Real-time برای فروشگاه متصل.

مشخصات OpenAPI

نسخهٔ ماشین‌خوان این جدول در /openapi/storebridge.json منتشر شده — شامل schema درخواست/پاسخ و طرح‌های امنیتی برای هر مسیر.

محدودیت شناخته‌شده

امروز سینک محصول فقط یک‌طرفه است (ووکامرس ← سلفی)؛ ویرایش محصول داخل سلفی هنوز به ووکامرس برنمی‌گردد. استرداد را از صفحهٔ Orders سلفی ثبت کن تا هر دو طرف هماهنگ بمانند.