Giao diện
API · sale-profile
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.
5 query · 4 mutation.
Query
mySaleAvatarView
Requires profile.manage (APP_SALE sale, OWN). A short-lived SIGNED view of the caller's OWN avatar (never a stable URL, never another account's picture: the media id comes from the caller's own profile, not from an argument). Null when there is no picture to draw (none set, pending, deleted); the app then shows initials. Re-read after expiresAt.
query · quyền: profile.manage
Không có tham số.
Trả về MediaView
| Field | Kiểu | Mô tả |
|---|---|---|
mediaId | ID! | |
visibility | MediaVisibility! | |
url | String! | |
expiresAt | DateTime |
mySaleProfile
Requires profile.manage (APP_SALE sale, OWN). Any other caller is forbidden.
query · quyền: profile.manage
Không có tham số.
Trả về SaleProfile!
| Field | Kiểu | Mô tả |
|---|---|---|
fullName | String | |
phoneMasked | String! | |
phoneVerified | Boolean! | |
avatarMediaId | ID | Read the image through mediaSignedView. |
contactEmail | String | |
contactAddress | String | |
idNumberMasked | String | ****1234; null when none is on file. |
bankAccountMasked | String | |
version | Int | Null until a first direct save or an approval creates the row. |
updatedAt | DateTime | |
approvedAt | DateTime | When a reviewer approved this Sale (the APP_SALE membership approval); null when the membership has none. There is no Sale code field: no source defines one (GAP-1740). |
missingRequired | [SaleProfileField!]! | |
fields | [SaleProfileFieldMeta!]! | |
pendingChange | SaleProfileChange |
mySaleProfileChanges
Requires profile.manage (APP_SALE sale, OWN). Newest submission first.
query · quyền: profile.manage
| Tham số | Kiểu | Mặc định | Mô tả |
|---|---|---|---|
page | Int | 1 | |
pageSize | Int | 20 |
Trả về SaleProfileChangePage!
| Field | Kiểu | Mô tả |
|---|---|---|
items | [SaleProfileChange!]! | |
page | Int! | |
pageSize | Int! | |
total | Int! |
saleProfileChange
Requires sale_profile_change.read (SPC-01).
query · quyền: sale_profile_change.read
| Tham số | Kiểu | Mặc định | Mô tả |
|---|---|---|---|
id | ID! |
Trả về SaleProfileChange!
| Field | Kiểu | Mô tả |
|---|---|---|
id | ID! | |
seq | Int! | |
status | SaleProfileChangeStatus! | |
fields | [SaleProfileFieldChange!]! | |
rejectionReason | String | Required on REJECTED; kept for every earlier submission. |
submittedAt | DateTime! | |
reviewedAt | DateTime | |
version | Int! | |
saleAccountId | ID! | |
salePhoneMasked | String! | Masked, display only. |
saleProfileChanges
Requires sale_profile_change.read (SPC-01). Oldest submission first; never the reviewer's own.
query · quyền: sale_profile_change.read
| Tham số | Kiểu | Mặc định | Mô tả |
|---|---|---|---|
status | SaleProfileChangeStatus | ||
page | Int | 1 | |
pageSize | Int | 20 |
Trả về SaleProfileChangePage!
| Field | Kiểu | Mô tả |
|---|---|---|
items | [SaleProfileChange!]! | |
page | Int! | |
pageSize | Int! | |
total | Int! |
Mutation
reviewSaleProfileChange
Requires sale_profile_change.review (SPC-02). Approve applies the new values; reject keeps the reason. Never the Sale's own request.
mutation · quyền: sale_profile_change.review
| Tham số | Kiểu | Mặc định | Mô tả |
|---|---|---|---|
input | ReviewSaleProfileChangeInput! |
Trả về SaleProfileChangeResult!
| Field | Kiểu | Mô tả |
|---|---|---|
aggregateId | ID! | |
version | Int! | |
status | CommandStatus! | |
requestId | ID! | |
correlationId | ID! | |
nextAction | NextAction | |
change | SaleProfileChange! |
saveSaleContact
Requires profile.manage. DIRECT edit of contact email and address (SPEC-06).
mutation · quyền: profile.manage
| Tham số | Kiểu | Mặc định | Mô tả |
|---|---|---|---|
input | SaveSaleContactInput! |
Trả về SaleProfileResult!
| Field | Kiểu | Mô tả |
|---|---|---|
aggregateId | ID! | |
version | Int! | |
status | CommandStatus! | |
requestId | ID! | |
correlationId | ID! | |
nextAction | NextAction | |
profile | SaleProfile! |
setSaleAvatar
Requires profile.manage. DIRECT edit of the avatar (own READY AVATAR media).
mutation · quyền: profile.manage
| Tham số | Kiểu | Mặc định | Mô tả |
|---|---|---|---|
input | SetSaleAvatarInput! |
Trả về SaleProfileResult!
| Field | Kiểu | Mô tả |
|---|---|---|
aggregateId | ID! | |
version | Int! | |
status | CommandStatus! | |
requestId | ID! | |
correlationId | ID! | |
nextAction | NextAction | |
profile | SaleProfile! |
submitSaleProfileChange
Requires profile.manage. Files a PROFILE_CHANGE request (full name, ID number, bank account). One PENDING request per Sale (conflict).
mutation · quyền: profile.manage
| Tham số | Kiểu | Mặc định | Mô tả |
|---|---|---|---|
input | SubmitSaleProfileChangeInput! |
Trả về SaleProfileChangeResult!
| Field | Kiểu | Mô tả |
|---|---|---|
aggregateId | ID! | |
version | Int! | |
status | CommandStatus! | |
requestId | ID! | |
correlationId | ID! | |
nextAction | NextAction | |
change | SaleProfileChange! |