commerce

POST `/v1/carts`

Open a shopping cart.

ማረጋገጫ

የAPI ቁልፉን እንደ bearer token ይላኩ። ቁልፉ የbilling.payment.manage ፈቃድ ሊኖረው ይገባል፤ ይህ ፈቃድ የሌለው ቁልፍ በ404 ሳይሆን በ403 ውድቅ ይደረጋል።

የድርጅትዎ መታወቂያ የሚገባበት ቦታ

ይህ ማቆሚያ ነጥብ (endpoint) org_idን በJSON አካል ውስጥ እንደ ሜዳ ይወስዳል።

የድርጅትዎ መለያ ቁጥር (ID) በዳሽቦርድዎ ላይ በሚገኙት የኤፒአይ ቁልፎች (API keys) ማያ ገጽ ላይ ከቁልፉ አጠገብ ይገኛል። በሚያደርጉት እያንዳንዱ ጥያቄ ላይ የሚጠቀሙበት መለያ ቁጥር አንድ አይነት ነው።

ሞክሩት

በቅንፍ ውስጥ ያለውን ማንኛውንም ነገር በራስዎ እሴቶች ይተኩ፣ እና ቁልፍ ቦታ ያዢውን ከዳሽቦርድዎ በመጣ ቁልፍ ይተኩ።

curl -X POST https://api.zinndigital.com/v1/carts \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

ገብተዋል? የመቆጣጠሪያ ማዕከልዎ ውስጥ ያለው የኤፒአይ ኮንሶል ትክክለኛውን የድርጅት መታወቂያዎን እና የራስዎን ቁልፍ ይሞላል፣ እና ትክክለኛውን ምላሽ ማየት እንዲችሉ ጥያቄውን በቀጥታ ከሚሰራው ኤፒአይ ጋር ያካሂደዋል። ይህን ኤንድፖይንት በAPI ኮንሶል ውስጥ ይክፈቱ

ዝርዝሮች

Creates an empty open cart for the organization. Prices on its lines are server-authoritative and re-computed on every read (the client price is never trusted). Requires `billing.payment.manage`.

የጥያቄ አካል

ስም	ዓይነት	የሚያስፈልግ	ምንነቱ
`org_id`	`Uuid \| null`	አይ	Defaults to the caller's org; the caller must hold `billing.payment.manage` there.
`product_line`	`string`	አይ	—
`currency`	`CurrencyCode \| null`	አይ	The currency to open the basket in — what the customer will be billed in. Omit it and the engine uses the `X-Zinn-Currency` header the dashboard already sends, falling back…

ምላሽ

ስም	ዓይነት	የሚያስፈልግ	ምንነቱ
`id`	`Uuid`	አዎ	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`org_id`	`Uuid`	አዎ	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`status`	`string<open, checking_out, converted, abandoned, expired>`	አዎ	—
`currency`	`CurrencyCode \| null`	አይ	Fixed when the cart is opened, from `CartCreate.currency` or the `X-Zinn-Currency` header, and then locked — every line must match it. Null only on a legacy cart created before…
`product_line`	`object`	አይ	—
`lines`	`CartLine[]`	አዎ	—
`subtotal`	`MoneyAmount`	አዎ	A money value — integer minor units + an ISO 4217 code (CLAUDE.md §2.8).
`discount`	`MoneyAmount`	አዎ	A money value — integer minor units + an ISO 4217 code (CLAUDE.md §2.8).
`total`	`MoneyAmount`	አዎ	A money value — integer minor units + an ISO 4217 code (CLAUDE.md §2.8).
`created_at`	`string`	አዎ	—
`updated_at`	`string`	አይ	—

ይህ ማብቂያ ሊመልሳቸው የሚችሉ ስህተቶች

401 · 403 · 422 · 429