public

POST `/v1/public/cart`

Open an anonymous cart.

احراز هویت

این نقطه پایانی عمومی است. هیچ مدرک احراز هویت و هیچ سازمانی نمی‌پذیرد — این همان چیزی است که سایت بازاریابی خودمان و موتورهای پاسخ‌دهنده هوش مصنوعی می‌خوانند.

این نقطه پایانی هیچ شناسه سازمانی را دریافت نمی‌کند. کلید شما در حال حاضر سازمان مربوطه را مشخص می‌کند و پاسخ در همان محدوده ارائه می‌شود.

امتحان کنید

هر چیزی را که داخل براکت‌های زاویه‌دار قرار دارد با مقادیر خودتان جایگزین کنید، و نگهدارنده کلید را با کلیدی از داشبورد خود جایگزین نمایید.

curl -X POST https://api.zinndigital.com/v1/public/cart \
  -H "Content-Type: application/json" \
  -d '{  }'

وارد شده‌اید؟ کنسول API در داشبورد شما شناسه سازمان واقعی و کلید خودتان را پر می‌کند و درخواست را روی API زنده اجرا می‌کند تا بتوانید پاسخ واقعی را ببینید. این نقطه پایانی را در کنسول API باز کنید

جزئیات

Creates an empty cart with no organization and no user and returns its opaque bearer token. The token is returned only here — nothing can re-derive it from the cart afterwards, so a client that loses it has lost the cart. It is a credential: treat it like one. The cart expires at expires_at (24 hours).

بدنه درخواست

نام	نوع	الزامی	چیست
`currency`	`CurrencyCode`	خیر	ISO 4217 currency code (money is minor units + this code — CLAUDE.md §2.8).
`product_line`	`string`	خیر	—

پاسخ

نام	نوع	الزامی	چیست
`id`	`Uuid`	بله	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`token`	`string`	خیر	The bearer token. Returned only from `createPublicCart` — it is absent on every subsequent read, because only its digest is stored.
`status`	`string<open, converted, expired>`	بله	—
`currency`	`CurrencyCode`	بله	ISO 4217 currency code (money is minor units + this code — CLAUDE.md §2.8).
`product_line`	`string`	خیر	—
`expires_at`	`string`	بله	After this the cart is gone — reads 404 whether or not it has been purged.
`items`	`PublicCartItem[]`	بله	—
`totals`	`PublicCartTotals`	بله	Pre-tax totals. Tax appears on the order, once a billing country exists.

خطاهایی که این نقطه پایانی می‌تواند برگرداند

422 · 429

POST /v1/public/cart