marketplace

PUT `/v1/marketplace/listings/{listing_id}/packages`

Replace the whole package list.

身份验证

请将 API 密钥作为 bearer 令牌发送。此端点在规范中未指明具体的权限，因此请为您的密钥赋予所需的最小权限，并通过检查响应来确认，而不是盲目假设。

此端点不需要组织 ID。您的密钥已用于识别其所属的组织，且响应范围也仅限于该组织。

免费试用

将尖括号中的内容替换为您自己的值，并将键占位符替换为您仪表板中的一个键。

curl -X PUT https://api.zinndigital.com/v1/marketplace/listings/{listing_id}/packages \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "packages": <object[]> }'

已登录？您仪表板中的 API 控制台会自动填入您真实的组织 ID 和您自己的密钥，并针对实时 API 运行请求，以便您查看实际的响应。在 API 控制台中打开此端点

详细信息

Whole-list, like the field schema and for the same reason: per-package create/delete reopens the read-then-write race defect **D824** recorded, and position ordering only means anything as a set. The cap is `Marketplace.max_packages` — a ROW an operator can change, not a database constraint that would need a migration (CLAUDE.md §2.35).

参数

名称	类型	必填	内容简介
`listing_id (path)`	`string`	是	—

请求正文

名称	类型	必填	内容简介
`packages`	`object[]`	是	—

响应

名称	类型	必填	内容简介
`data`	`MarketplacePackage[]`	是	—
`total`	`integer`	是	—
`max_packages`	`integer`	是	This vertical's cap, from a row an operator can change.
`permitted_billing_modes`	`MarketplaceBillingMode[]`	否	What this listing type allows. The form is TOLD rather than guessing: a UI that hardcoded both modes would render a control whose every submission is refused.
`permitted_billing_intervals`	`string<monthly, annual>[]`	否	—

此端点可能返回的错误

401 · 404 · 422

PUT /v1/marketplace/listings/{listing_id}/packages