Retrieving Messages

This guide explains how to retrieve the content of a secure message.

Use Cases

  • Retrieve a message sent by a client (reply)
  • Download attached files
  • Check message status

Retrieve a Message

using SecureExchangesSDK.Helpers;
using SecureExchangesSDK.Models.Args;

// Parse the message link
string messageLink = "https://www.secure-exchanges.com/read.aspx?Sess=...";
SecureExchangesMessage msg = MessageHelper.GetSecureExchangesMessageFromLink(messageLink);

// Retrieve content
Uri endpoint = new Uri("https://www.secure-exchanges.com/_api/0217/0217.asmx");

var args = new GetMessageArgs(
    endpoint,
    serial,
    apiUser,
    apiPassword,
    msg,
    password: null,  // Password if the message has one
    digit: ""        // Opening code if required
);

GetMessageResponse response = MessageHelper.GetMessage(args);

if (response.Status == 200)
{
    Console.WriteLine($"Body: {response.Body}");
    Console.WriteLine($"Subject: {response.Subject}");
    Console.WriteLine($"Files: {response.FilesMetaData?.Files?.Count ?? 0}");
}

Download Files

// After retrieving the message
if (response.FilesMetaData?.Files != null)
{
    foreach (var file in response.FilesMetaData.Files)
    {
        Console.WriteLine($"File: {file.FileName}");
        Console.WriteLine($"Size: {file.FileSize} bytes");
        Console.WriteLine($"Type: {file.MimeType}");

        // Download the file via FileHelper
        // Content will be in file.Binary after download
    }
}

See Also