marketplace
GET /v1/marketplace/vendor/ledger
What the seller is owed, and what is still being held.
การยืนยันตัวตน
ส่ง API key เป็น 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