marketplace
GET /v1/marketplace/vendor/ledger
What the seller is owed, and what is still being held.
Uwierzytelnianie
Wyślij klucz API jako token bearer. Ten punkt końcowy nie określa konkretnego uprawnienia w specyfikacji, więc nadaj swojemu kluczowi minimum potrzebnych uprawnień i sprawdź odpowiedź zamiast zakładać.
Ten punkt końcowy nie wymaga identyfikatora organizacji. Twój klucz już identyfikuje organizację, do której należy, a odpowiedź jest do niej ograniczona.
Wypróbuj
Zastąp wszystko w nawiasach ostrych własnymi wartościami, a zastępczy znacznik klucza kluczem ze swojego pulpitu nawigacyjnego.
curl -X GET https://api.zinndigital.com/v1/marketplace/vendor/ledger \
-H "Authorization: Bearer zdk_live_…"Zalogowany? Konsola API w Twoim panelu uzupełnia rzeczywiste identyfikator organizacji oraz Twój własny klucz i wykonuje żądanie względem aktywnego API, dzięki czemu możesz zobaczyć rzeczywistą odpowiedź. Otwórz ten punkt końcowy w konsoli API
Szczegóły
"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.
Parametry
| Nazwa | Typ | Wymagane | Co to jest |
|---|---|---|---|
cursor (query) | string | Nie | Opaque cursor from a previous page's page.next_cursor. |
limit (query) | integer | Nie | Maximum items to return (page size). |
Odpowiedź
| Nazwa | Typ | Wymagane | Co to jest |
|---|---|---|---|
data | MarketplaceLedgerEntry[] | Tak | — |
page | PageMeta | Tak | — |
balance | MarketplaceLedgerBalance | Tak | 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… |
Błędy, które ten punkt końcowy może zwrócić
401