Event Attachment OpCode EAC: Create or Update an Attachment to an Event

This opcode is used to update an existing attachment in the list of attachments (documents/links) if found, or create a new attachment for the specified event. The event to update the attachment may be identified by specifying the EventKey, EventDescription, or EventCode.

Attachments can be links (URLs) or actual files uploaded to the system. When updating URL links, no special treatment is necessary. However, when uploading files, certain steps must be taken. File uploads must be the only opcode specified in the OpCodeList. This means that uploading files must be done as separate calls to the API. Additionally, uploading of files must be done using HTTPS multipart form posts.

Calling the API

The API is called via a secure HTTPS request. This HTTPS request may be a GET or POST operation (except for file uploading which requires a multi-part form post). Each request must supply the authentication credentials assigned to the caller by Notified. Only requests with valid credentials will be processed. These credentials identify the caller and provide access only to a specific customer area.

The format of the API call is: https://api.onlinexperiences.com/scripts/Server.nxp?LASCmd=AI:4;F:APIUTILS!50540&APIUserAuthCode={YourAuthCode}&APIUserCredentials={YourCredentials}&OpCodeList={Opcode[OpCode[…]]}&OutputFormat={X|H|T(default)}&ShowKey={ShowKey}&{Additional, opcode-specific parameters in name=value format…}

Specific parameter ordering is unimportant, with the only restriction being that the first parameter MUST BE LASCmd=AI:4;F:APIUTILS!50540. All other parameters may appear in any sequence order.

Return Outputs

See the descriptions of OpCodes EAI and EAU for more information on the return completion results.

Potential Error Codes

See the descriptions of OpCodes EAI and EAU for more information on the potential error codes.