Giao diện
API · sale-transition
Trang sinh tự động
Parse từ schema.graphql (SDL backend export) bằng parser graphql. Mô tả và quyền lấy nguyên văn từ description trong SDL.
1 query · 2 mutation.
Query
saleTransition
The caller's own transition (Sale App), or null when there is no application. tier.read (own).
query · SDL không ghi quyền
Không có tham số.
Trả về SaleTransition
| Field | Kiểu | Mô tả |
|---|---|---|
applicationId | ID! | |
status | SaleTransitionStatus! | |
attempts | Int! | How many times the server ran the transfer (0 before the first run). |
failureCode | String | Stable code of the last failure; never a message or data. |
fromTier | TierRef | The User Tier held at the transfer; null until it completed. |
toTier | TierRef | Sale Standard; null until it completed. |
carriedRankPoints | PointAmount | Valid (unexpired) rank carried at the transfer, each lot with its original expiry. |
carriedLotCount | Int | |
completedAt | DateTime | |
acknowledgedAt | DateTime | Set once by acknowledgeSaleTransition: the person saw the completed result. |
evaluationOutcome | TierEvaluationOutcome | The immediate Sale Tier evaluation after the transfer (rank AND Mission). |
evaluationDecision | TierDecision |
Mutation
acknowledgeSaleTransition
The person saw the completed result: set once on the server (the app keeps nothing locally). Conflict (transition_not_completed) before the transfer completed. sale_transition.update (own).
mutation · SDL không ghi quyền
| Tham số | Kiểu | Mặc định | Mô tả |
|---|---|---|---|
input | AcknowledgeSaleTransitionInput! |
Trả về SaleTransitionResult!
| Field | Kiểu | Mô tả |
|---|---|---|
aggregateId | ID! | The application id. |
version | Int! | Attempts after the command. |
status | CommandStatus! | |
requestId | ID! | |
correlationId | ID! | |
nextAction | NextAction | |
transition | SaleTransition! |
retrySaleTransition
Runs the transfer of the caller's own User request again. Idempotent: a completed transfer answers COMPLETED and adds nothing; a failure leaves nothing half done. sale_transition.update (own).
mutation · SDL không ghi quyền
| Tham số | Kiểu | Mặc định | Mô tả |
|---|---|---|---|
input | RetrySaleTransitionInput! |
Trả về SaleTransitionResult!
| Field | Kiểu | Mô tả |
|---|---|---|
aggregateId | ID! | The application id. |
version | Int! | Attempts after the command. |
status | CommandStatus! | |
requestId | ID! | |
correlationId | ID! | |
nextAction | NextAction | |
transition | SaleTransition! |