رفتن به محتوای اصلی
تاریوا برای فروشگاهم می‌خواهم
توسعه‌دهنده

Live Commerce Bridge

درخواست و پاسخ امضاشده سرور-به-سرور بدون اعتبار دیتابیس فروشنده.

در این راهنما

فروشنده یک endpoint مثل /taryva/live-commerce میزبانی می‌کند. تاریوا POST امضاشده می‌فرستد.

هدرهای درخواست

  • X-Taryva-Bridge-Protocol: 1.0
  • X-Taryva-Site-Key
  • X-Taryva-Timestamp
  • X-Taryva-Nonce
  • X-Taryva-Body-SHA256
  • X-Taryva-Request-Id
  • X-Taryva-Signature

امضا روی canonical string نسخه TARYVA-LIVE-BRIDGE-V1 است. پاسخ هم باید X-Taryva-Response-Signature داشته باشد.

بدنه

json
{
  "tool": "get_live_price",
  "arguments": {"target_ref": "catalog:ap-jkt-001-40"},
  "request_id": "uuid",
  "idempotency_key": null
}

پاسخ موفق:

json
{"ok": true, "data": {}}

خطا: {"ok": false, "error": {"code": "live_bridge_error", "retryable": false}}

قابلیت‌ها

اولین probe با bridge_capabilities است. ابزارهایی که اعلام نشده‌اند اجرا نمی‌شوند.

آزمایش محلی: پروفایل Compose custom-demo و فروشگاه روی custom-demo-store:8080.