extras
GET /v1/extra-purchases/{purchaseId}
Get an extra purchase.
تصدیقهویت
یو API کی د بیئرر ټوکن (bearer token) په توګه ولیکئ. کی باید د billing.view اجازه ولري؛ له دې اجازې پرته کی د 404 پرځای د 403 په واسطه رد کیږي.
دا پای نقطه د سازمان هېڅ آی ډي نه اخلي. ستاسو کیلي مخکې تر مخکې هغه سازمان په ګوته کوي چې پورې اړه لري، او ځواب ورته محدود دی.
هڅه وکړئ
د انګلیسي په زاوي پنسونو کې هرڅه د خپلو ارزښتونو سره بدل کړئ، او د کلي ځای لرونکی ستاسو د ډشبورډ د کلي سره.
curl -X GET https://api.zinndigital.com/v1/extra-purchases/{purchaseId} \
-H "Authorization: Bearer zdk_live_…"ننوتي یاست؟ ستاسو په ډشبورډ کې د API کنسول ستاسو د اصلي سازمان ID او ستاسو خپله کیلي ډکوي، او غوښتنه د ژوندی API په وړاندې پرمخ وړي ترڅو تاسو وکولی شئ اصلي ځواب وګورئ. دا پای ټکی (endpoint) د API په کنسول کې پرانیزئ
تفصیلات
Returns one extra purchase in scope with its status and outcome. Requires billing.view.
پارامترونه
| نوم | ډول | اړین | دا څه شی دی |
|---|---|---|---|
purchaseId (path) | Uuid | هو | The extra purchase's id. |
ځواب
| نوم | ډول | اړین | دا څه شی دی |
|---|---|---|---|
id | Uuid | هو | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
org_id | Uuid | هو | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
extra_id | Uuid | هو | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
site_id | object | نه | — |
domain_id | object | نه | — |
status | ExtraPurchaseStatus | هو | An extra purchase's lifecycle state. |
category | string | هو | — |
fulfilment_type | ExtraFulfilmentType | هو | How an extra is delivered. |
interval | ExtraInterval | هو | One-off charge or a recurring subscription. |
price | MoneyAmount | هو | A money value — integer minor units + an ISO 4217 code (CLAUDE.md §2.8). |
recurrence | string<none, active, ended> | هو | Whether the recurrence behind this purchase is still live. none = it never recurred (a one-off); active = a scheduled charge exists; ended = it recurred and no longer does.… |
next_renewal_on | object | نه | The next charge date, or null. Also null for a live charge that has no date scheduled yet, so read recurrence — not this field — to decide whether a purchase renews at all. |
sla_due_at | object | نه | — |
completed_at | object | نه | — |
failure_reason | string | نه | — |
created_at | string | هو | — |
updated_at | string | هو | — |
تېروتنې چې دا پای ټکی یې بیرته راګرځولی شي
401 · 403 · 404 · 429