marketplace

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

Replace the whole package list.

Аутентификация

Передайте API-ключ в качестве маркера носителя (bearer token). Эта конечная точка не указывает конкретное разрешение в спецификации, поэтому предоставьте своему ключу минимум необходимых прав и проверьте ответ, вместо того чтобы делать предположения.

Этот эндпоинт не принимает идентификатор организации. Ваш ключ уже определяет организацию, к которой он принадлежит, и ответ ограничивается ее рамками.

Попробовать

Замените всё в угловых скобках на собственные значения, а плейсхолдер ключа — на ключ из вашей панели управления.

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 в вашей панели управления автоматически подставляет реальный идентификатор вашей организации и ваш собственный ключ, а также выполняет запрос к работающему 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