marketplace
GET /v1/marketplace/vendor/ledger
What the seller is owed, and what is still being held.
Аутентификация
Передайте API-ключ в качестве маркера носителя (bearer token). Эта конечная точка не указывает конкретное разрешение в спецификации, поэтому предоставьте своему ключу минимум необходимых прав и проверьте ответ, вместо того чтобы делать предположения.
Этот эндпоинт не принимает идентификатор организации. Ваш ключ уже определяет организацию, к которой он принадлежит, и ответ ограничивается ее рамками.
Попробовать
Замените всё в угловых скобках на собственные значения, а плейсхолдер ключа — на ключ из вашей панели управления.
curl -X GET https://api.zinndigital.com/v1/marketplace/vendor/ledger \
-H "Authorization: Bearer zdk_live_…"Вошли в систему? Консоль API в вашей панели управления автоматически подставляет реальный идентификатор вашей организации и ваш собственный ключ, а также выполняет запрос к работающему API, чтобы вы могли увидеть актуальный ответ. Откройте эту конечную точку в API-консоли
Подробнее
"Funds are held securely by Zinn® until the buyer accepts delivery" (docs/82 §1) is a promise to two people, and the seller is the one who needs to watch it — a balance they cannot see is indistinguishable from not being paid. The three balance figures are computed over every entry by the database, not summed from data. They are kept separate rather than netted because they answer different questions: pending is what no buyer has accepted yet, released is what the next weekly payout run will pay, paid is history.
Параметры
| Имя | Тип | Обязательно | Что это |
|---|---|---|---|
cursor (query) | string | Нет | Opaque cursor from a previous page's page.next_cursor. |
limit (query) | integer | Нет | Maximum items to return (page size). |
Ответ
| Имя | Тип | Обязательно | Что это |
|---|---|---|---|
data | MarketplaceLedgerEntry[] | Да | — |
page | PageMeta | Да | — |
balance | MarketplaceLedgerBalance | Да | Computed by the database over EVERY entry, never summed from the page above it — a paginated list summed in a client is wrong from the second page onward, and wrong about the… |
Ошибки, которые может возвращать этот эндпоинт
401