public

POST /v1/public/cart

Open an anonymous cart.

すべての public エンドポイント

認証

このエンドポイントは公開されています。認証情報や組織情報は不要で、当社のマーケティングサイトやAI回答エンジンが読み取っているものと同じです。

このエンドポイントは組織IDを受け付けません。お使いのキーによって所属する組織がすでに特定されており、レスポンスはその組織にスコープされます。

試してみる

アングルブラケット内のすべてをご自身の値に置き換え、キーのプレースホルダーをご利用中のダッシュボードのキーに置き換えてください。

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

ログインしていますか?ダッシュボード内のAPIコンソールでは、実際の組織IDやお客様ご自身のキーが自動入力され、ライブ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).

リクエスト本文

名前タイプ必須これがその内容です
currencyCurrencyCodeいいえISO 4217 currency code (money is minor units + this code — CLAUDE.md §2.8).
product_linestringいいえ

返信

名前タイプ必須これがその内容です
idUuidはいUUIDv7 identifier — sortable by creation time (docs/02 §8).
tokenstringいいえThe bearer token. Returned **only** from `createPublicCart` — it is absent on every subsequent read, because only its digest is stored.
statusstring<open, converted, expired>はい
currencyCurrencyCodeはいISO 4217 currency code (money is minor units + this code — CLAUDE.md §2.8).
product_linestringいいえ
expires_atstringはいAfter this the cart is gone — reads 404 whether or not it has been purged.
itemsPublicCartItem[]はい
totalsPublicCartTotalsはいPre-tax totals. Tax appears on the order, once a billing country exists.

このエンドポイントが返すエラー

422 · 429