Skip to content

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

FieldKiểuMô tả
mediaIdID!
visibilityMediaVisibility!
urlString!
expiresAtDateTime

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!

FieldKiểuMô tả
fullNameString
phoneMaskedString!
phoneVerifiedBoolean!
avatarMediaIdIDRead the image through mediaSignedView.
contactEmailString
contactAddressString
idNumberMaskedString****1234; null when none is on file.
bankAccountMaskedString
versionIntNull until a first direct save or an approval creates the row.
updatedAtDateTime
approvedAtDateTimeWhen 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!]!
pendingChangeSaleProfileChange

mySaleProfileChanges ​

Requires profile.manage (APP_SALE sale, OWN). Newest submission first.

query · quyền: profile.manage

Tham sốKiểuMặc địnhMô tả
pageInt1
pageSizeInt20

Trả về SaleProfileChangePage!

FieldKiểuMô tả
items[SaleProfileChange!]!
pageInt!
pageSizeInt!
totalInt!

saleProfileChange ​

Requires sale_profile_change.read (SPC-01).

query · quyền: sale_profile_change.read

Tham sốKiểuMặc địnhMô tả
idID!

Trả về SaleProfileChange!

FieldKiểuMô tả
idID!
seqInt!
statusSaleProfileChangeStatus!
fields[SaleProfileFieldChange!]!
rejectionReasonStringRequired on REJECTED; kept for every earlier submission.
submittedAtDateTime!
reviewedAtDateTime
versionInt!
saleAccountIdID!
salePhoneMaskedString!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ểuMặc địnhMô tả
statusSaleProfileChangeStatus
pageInt1
pageSizeInt20

Trả về SaleProfileChangePage!

FieldKiểuMô tả
items[SaleProfileChange!]!
pageInt!
pageSizeInt!
totalInt!

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ểuMặc địnhMô tả
inputReviewSaleProfileChangeInput!

Trả về SaleProfileChangeResult!

FieldKiểuMô tả
aggregateIdID!
versionInt!
statusCommandStatus!
requestIdID!
correlationIdID!
nextActionNextAction
changeSaleProfileChange!

saveSaleContact ​

Requires profile.manage. DIRECT edit of contact email and address (SPEC-06).

mutation · quyền: profile.manage

Tham sốKiểuMặc địnhMô tả
inputSaveSaleContactInput!

Trả về SaleProfileResult!

FieldKiểuMô tả
aggregateIdID!
versionInt!
statusCommandStatus!
requestIdID!
correlationIdID!
nextActionNextAction
profileSaleProfile!

setSaleAvatar ​

Requires profile.manage. DIRECT edit of the avatar (own READY AVATAR media).

mutation · quyền: profile.manage

Tham sốKiểuMặc địnhMô tả
inputSetSaleAvatarInput!

Trả về SaleProfileResult!

FieldKiểuMô tả
aggregateIdID!
versionInt!
statusCommandStatus!
requestIdID!
correlationIdID!
nextActionNextAction
profileSaleProfile!

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ểuMặc địnhMô tả
inputSubmitSaleProfileChangeInput!

Trả về SaleProfileChangeResult!

FieldKiểuMô tả
aggregateIdID!
versionInt!
statusCommandStatus!
requestIdID!
correlationIdID!
nextActionNextAction
changeSaleProfileChange!

Sinh từ ad83b0aea · 820 migration · PostgreSQL 17