Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: V1.03

...

Send (Post)Retrieve (Post)
MessageResponseRequest 
Expand
titleRequest...
FieldDetails
organisationResponse
Expand
title...
FieldDetails
retrievedAtUtc*string($date-time)

Server-supplied timestamp showing time of Message retrieval and storage in organisation's own systems

referenceMessageId*string($uuid)
responseType*

string

Enum:
Array [  3 warning, acknowledge, deny ]

remark

string

maxLength: 1000
nullable: true

Expand
titleResponse...
FieldDetails
wmdaResponsemetaInformation*Embedded WMDA Response Meta Block
Expand
titleRequest...
limitinteger
default: 100

shouldPeekboolean
default: false

Set to true if you want messages to remain available after retrieval

messageSequenceNumber

integer
e
xamplet: 12345

Optional field to request a message with a specific messageSequenceNumber. If that message (no longer) exists then no message will be returned.

Expand
titleResponse...
FieldDetails
generalInformation*Embedded General Information Block
messages*
Expand
title...
FieldDetails
originalMessage*
{}


metaInformation*Embedded Meta Block

6.3 Text message [TXT_MSG]

...

Send (Post)Retrieve (Post)
textMessageRequest
Expand
titleRequest...
Field

Details

requestingRegistryReferenceCoderequestId

string
maxLength: 1519
example:XX12345
nullable: true

text*

string
nullable: true
example: Would it be possible to also perform IDM test for SARS-CoV-23?

Text. Message for a human at receiving registry.

receivingRegistry*string
maximum: 9999

minimum: 0

maxLength: 4

minLength: 4

example: 1234

4 digit ION of the receiving registry

patient*Patient ID
Expand
title...
FieldDetails
wmdaId*

integer
nullable: false

example: 1234

ID provided by the WMDA

donor*Embedded Donor Block (donor in request)donor*Donor ID
Expand
titleResponse...
FieldDetails
wmdaResponsemetaInformation*Embedded WMDA Response Meta Block
Expand
titleRequest...
limitinteger
default: 100

shouldPeekboolean
default: false

Set to true if you want messages to remain available after retrieval

messageSequenceNumber

integer
e
xamplet: 12345

Optional field to request a message with a specific messageSequenceNumber. If that message (no longer) exists then no message will be returned.

Expand
titleResponse...
FieldDetails
generalInformation*Embedded General Information Block
messages*
Expand
title...
FieldDetails
originalMessage*
{}


metaInformation*Embedded Meta Block

6.4 Alert message

The Alert message is used to broadcast an important information about the system, like planned service outage. Messages are generated centrally by WMDA. Members are expected to display them to the users.

...

SendRetrieve (Post)

AlertRetrieve
Alerts can only be sent by the WMDA's central system
Expand
titleRequest...
limitinteger
default: 100

shouldPeekboolean
default: false

Set to true if you want messages to remain available after retrieval

messageSequenceNumber

integer
e
xamplet: 12345

Optional field to request a message with a specific messageSequenceNumber. If that message (no longer) exists then no message will be returned.

Expand
titleResponse...
FieldDetails
generalInformation*Embedded General Information Block
originalMessagemessages*
Expand
title...
FieldDetails
levelstring

alert level. enums may change

Enum:
Array [ 3 ]
statusstring

check later

Enum:
Array [ 2 ]
messageTextstring
maxLength: 1024

example: WMDA will do maintenance on SMC system on the weekend of 10 march
originalMessage*

...

metaInformation*Embedded Meta Block

6.5 Alert Update message

The Alert  Update message is used to broadcast an update about some previous alert. Messages are generated centrally by WMDA. Members are expected to display them to the users.

...

SendRetrieve (Post)

AlertUpdateRetrieve
Alert updates can only be sent by the WMDA's central system
Expand
titleRequest...
limitinteger
default: 100

shouldPeekboolean
default: false

Set to true if you want messages to remain available after retrieval

messageSequenceNumber

integer
e
xamplet: 12345

Optional field to request a message with a specific messageSequenceNumber. If that message (no longer) exists then no message will be returned.

Expand
titleResponse...
metaInformation
FieldDetails
generalInformation*Embedded General Information Block
originalMessagemessages*
Expand
title...
FieldDetails
alertReferenceIdentifierstring($uuid)
levelstring

alert level. enums may change

Enum:
Array [ 3 ]
statusstring

check later

Enum:
Array [ 2 ]
messagestring
maxLength: 1024

example: WMDA will do maintenance on SMC system on the weekend of 10 march
originalMessage*

...

metaInformation*Embedded Meta Block

6.6 Available Messages

This endpoint allows end users to retrieve an overview of all messages that are ready to be downloaded, including their corresponding sequence numbers. This information can be used to retrieve the messages from their respective *retrieve endpoints. If desired, the messages can be pulled in chronological order, given by the sequence numbers. Each "retrieve" endpoint will have the optional parameter "sequenceNumber", that allows for an indivual collection of the corresponding message(s). If that parameter is left empty all available messages are retrieved (according to the limit set in the parameters). 

...