public

POST `/v1/public/cart/{token}/extra`

Add one purchasable service (an addon) to an anonymous cart.

احراز هویت

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

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

امتحان کنید

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

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

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

جزئیات

Owner ruling 2026-09-09: the order configuration page upsells addons "suitable for the hosting type", and its running total has to match what checkout charges to the minor unit. That second half is what makes an addon a basket LINE rather than a second purchase path — a total including something the basket cannot hold would be a second place that adds money up. The price is computed by the server from the catalogue in the cart's own currency; anything sent by the client is ignored. Which addons this basket may buy is read from its own plan line, never from the request: this endpoint is anonymous, so a caller-supplied product line would put every PBN-only addon one request away from any basket. A basket with no plan in it can buy only the addons sold on every line. 422 covers all three refusals — withdrawn (no fulfilment handler is registered, so we could take the money and run nothing), not sold on this product line, or already in the basket. One of each service per basket.

پارامترها

نام	نوع	الزامی	چیست
`token (path)`	`string`	بله	The anonymous cart's opaque bearer token (`zgc_…`), as returned by `createPublicCart`. It is a credential — anyone holding it can read and modify the cart — and it travels in…

بدنه درخواست

نام	نوع	الزامی	چیست
`code`	`string`	بله	The catalogue code of the service being added (`managed_migration`, `site_speedup_standard`, …), from `OrderConfig.addons`. One field, and deliberately no product line beside it:…

پاسخ

نام	نوع	الزامی	چیست
`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.

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

404 · 422 · 429

POST /v1/public/cart/{token}/extra