Live Commerce Bridge
درخواست و پاسخ امضاشده سرور-به-سرور بدون اعتبار دیتابیس فروشنده.
در این راهنما
فروشنده یک endpoint مثل /taryva/live-commerce میزبانی میکند. تاریوا POST امضاشده میفرستد.
هدرهای درخواست
X-Taryva-Bridge-Protocol: 1.0X-Taryva-Site-KeyX-Taryva-TimestampX-Taryva-NonceX-Taryva-Body-SHA256X-Taryva-Request-IdX-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.