Skip to content

API · mission ​

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.

7 query · 4 mutation.

Query ​

mission ​

Requires mission.read (MS-01).

query · quyền: mission.read

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

Trả về Mission!

FieldKiểuMô tả
idID!
codeString!
purposeMissionPurpose!
audienceMissionAudience!
nameString!
descriptionString
currentMissionVersionNon-draft version whose window contains now (paused included), else null.
draftMissionVersionOpen DRAFT version, if any (one at a time).
latestMissionVersionHighest version number.
versions[MissionVersion!]!All versions, newest first; history is never deleted.
createdByID!
createdAtDateTime!
updatedAtDateTime!
versionInt!

missionEvidence ​

Evidence behind one assignment (Admin). mission_progress.read (MPR-02).

query · SDL không ghi quyền

Tham sốKiểuMặc địnhMô tả
assignmentIdID!
criterionIdID
pageInt
pageSizeInt

Trả về MissionEvidencePage!

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

missionPauseImpact ​

Requires mission.pause (MS-03). Read-only.

query · quyền: mission.pause

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

Trả về MissionPauseImpact!

FieldKiểuMô tả
versionIdID!
missionIdID!
activityMissionActivity!
canPauseBoolean!False when the version is not PUBLISHED or its window has ended.
blockReasonStringWhy canPause is false: not_published, window_ended or pause_in_past.
effectiveAtDateTime!
assignedCountInt!
completedCountInt!
inProgressCountInt!Assigned and not completed: progress stays readable, no new contribution after the pause.
withProgressCountInt!In progress with recorded evidence (net contributions > 0).
contributionCountInt!
reversalCountInt!
requiredByMissionDependencies!
asOfDateTime!

missionProgress ​

One account's Missions with criterion progress (Admin). mission_progress.read (MPR-02).

query · SDL không ghi quyền

Tham sốKiểuMặc địnhMô tả
accountIdID!
purposeMissionPurpose
pageInt
pageSizeInt

Trả về MissionProgressPage!

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

missions ​

Requires mission.read (MS-01). Filters combine with AND; status = has a version in that state.

query · quyền: mission.read

Tham sốKiểuMặc địnhMô tả
searchString
purposeMissionPurpose
audienceMissionAudience
statusMissionVersionStatus
pageInt
pageSizeInt

Trả về MissionPage!

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

myMissionEvidence ​

Evidence behind one of the caller's own assignments. mission_progress.read (own, MPR-01).

query · SDL không ghi quyền

Tham sốKiểuMặc địnhMô tả
assignmentIdID!
criterionIdID
pageInt
pageSizeInt

Trả về MissionEvidencePage!

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

myMissions ​

The caller's own Missions in this app, newest first; purpose filters one group. mission_progress.read (own, MPR-01).

query · SDL không ghi quyền

Tham sốKiểuMặc địnhMô tả
purposeMissionPurpose
pageInt
pageSizeInt

Trả về MissionProgressPage!

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

Mutation ​

assignMission ​

Requires mission.assign (MS-04, GAP-45: denied for every caller today).

mutation · quyền: mission.assign

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

Trả về AssignMissionResult!

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

pauseMission ​

Requires mission.pause (MS-03). PUBLISHED -> PAUSED, set once.

mutation · quyền: mission.pause

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

Trả về MissionVersionResult!

FieldKiểuMô tả
aggregateIdID!
versionInt!
statusCommandStatus!
requestIdID!
correlationIdID!
nextActionNextAction
missionIdID!
missionVersionMissionVersion!
closedVersionIds[ID!]!Predecessor versions whose open window this publish closed.

publishMission ​

Requires mission.write (MS-02). DRAFT -> PUBLISHED.

mutation · quyền: mission.write

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

Trả về MissionVersionResult!

FieldKiểuMô tả
aggregateIdID!
versionInt!
statusCommandStatus!
requestIdID!
correlationIdID!
nextActionNextAction
missionIdID!
missionVersionMissionVersion!
closedVersionIds[ID!]!Predecessor versions whose open window this publish closed.

saveMissionDraft ​

Requires mission.write (MS-02).

mutation · quyền: mission.write

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

Trả về MissionVersionResult!

FieldKiểuMô tả
aggregateIdID!
versionInt!
statusCommandStatus!
requestIdID!
correlationIdID!
nextActionNextAction
missionIdID!
missionVersionMissionVersion!
closedVersionIds[ID!]!Predecessor versions whose open window this publish closed.

Sinh từ ad83b0aea · 820 migration · PostgreSQL 17