diff --git a/SendsafelyAPI/ClientAPI.cs b/SendsafelyAPI/ClientAPI.cs index 82db60a..bb634c3 100644 --- a/SendsafelyAPI/ClientAPI.cs +++ b/SendsafelyAPI/ClientAPI.cs @@ -332,8 +332,7 @@ public void DeletePackage(String packageId) } /// - /// Deletes a temporary package. This action must be called before the package is finalized. Before this function can be called, the package must have been created with - /// CreatePackage(). + /// Deletes a temporary package, which is a package that has not yet been finalized. /// /// The unique package id of the package to be deleted. /// Thrown when the API has not been initialized. @@ -853,6 +852,15 @@ public List GetArchivedPackages() /// /// List object of Contact Groups and email addresses. /// + public List GetContactGroups() + { + EnforceInitialized(); + + PackageUtility pu = new PackageUtility(connection); + return pu.GetContactGroups(false); + } + + [Obsolete("getContactGroups is deprecated, please use GetContactGroups instead", false)] public List getContactGroups() { EnforceInitialized(); @@ -897,6 +905,15 @@ public List GetDropzoneRecipients() /// /// List object of Contact Groups and email addresses. /// + public List GetEnterpriseContactGroups() + { + EnforceInitialized(); + + PackageUtility pu = new PackageUtility(connection); + return pu.GetContactGroups(true); + } + + [Obsolete("getEnterpriseContactGroups is deprecated, please use GetEnterpriseContactGroups instead", false)] public List getEnterpriseContactGroups() { EnforceInitialized(); @@ -940,9 +957,9 @@ public FileInformation GetFileInformation(String packageId, String directoryId, } /// - /// Downloads and decrypts a keycode from the Server given a packageId and a private key. + /// Downloads and decrypts a keycode from the server for a given packageId and RSA Key pair. /// - /// The private key associated with the package for the keycode. + /// The private key associated with the RSA Key pair used to encrypt the package keycode. /// The package id for the keycode. /// Thrown when the API has not been initialized. /// Will be thrown if the server returns an error message while downloading the keycode. @@ -1035,6 +1052,20 @@ public PackageInformation GetPackageInformation(String packageId) /// /// A PackageInformation object containing information about the package. /// + public PackageInformation GetPackageInformationFromLink(Uri link) + { + EnforceInitialized(); + + if (link == null) + { + throw new InvalidPackageException("The supplied link is null"); + } + + PackageUtility pu = new PackageUtility(connection); + return pu.GetPackageInformationFromLink(link); + } + + [Obsolete("getPackageInformationFromLink is deprecated, please use GetPackageInformationFromLink instead", false)] public PackageInformation getPackageInformationFromLink(Uri link) { EnforceInitialized(); @@ -1094,7 +1125,7 @@ public String GetPackageLink(String packageId, String keyCode) } /// - /// Retrieves a list of all active received packages for the given API User. + /// Retrieves a list of all active packages received for the given API User. /// /// Thrown when the API has not been initialized. /// Thrown when the API credentials are incorrect. @@ -1130,11 +1161,11 @@ public Recipient GetRecipient(String packageId, String recipientId) } /// - /// Retrieves all packages belonging to the given Recipient. + /// Retrieves a list of packages where the passed in email address is a package recipient. /// - /// The recipient Email for which the packages information should be fetched. + /// The email address of the recipient. /// - /// A PackageInfo object containing information about the package. + /// A PackageInfo object containing information about each package retrieved, including confirmed downloads for the recipient. /// public List GetRecipientHistory(String recipientEmail) { diff --git a/SendsafelyAPI/CountryCodes.cs b/SendsafelyAPI/CountryCodes.cs index fa4819a..a83836f 100644 --- a/SendsafelyAPI/CountryCodes.cs +++ b/SendsafelyAPI/CountryCodes.cs @@ -40,7 +40,8 @@ public enum CountryCode ES = 34, SE = 46, CH = 41, - AE = 971 + AE = 971, + OT }; /// @@ -76,7 +77,8 @@ public enum CountryCode { CountryCode.ES, "Spain" }, { CountryCode.SE, "Sweden" }, { CountryCode.CH, "Switzerland" }, - { CountryCode.AE, "United Arab Emirates" } + { CountryCode.AE, "United Arab Emirates" }, + { CountryCode.OT, "Other" } }; } } diff --git a/SendsafelyAPI/Exceptions/TwoFAEnforcedException.cs b/SendsafelyAPI/Exceptions/TwoFAEnforcedException.cs new file mode 100644 index 0000000..c15f7f5 --- /dev/null +++ b/SendsafelyAPI/Exceptions/TwoFAEnforcedException.cs @@ -0,0 +1,20 @@ +using System; +using System.Collections.Generic; +using System.Text; + +namespace SendSafely.Exceptions +{ + /// + /// Thrown when an organization enforce two fa flag is true + /// + [Serializable] + public class TwoFAEnforcedException : BaseException + { + public TwoFAEnforcedException(String message) + : base(message) + { + ; + } + } + +} diff --git a/SendsafelyAPI/SendsafelyAPI.csproj b/SendsafelyAPI/SendsafelyAPI.csproj index 725ec59..21f84c1 100644 --- a/SendsafelyAPI/SendsafelyAPI.csproj +++ b/SendsafelyAPI/SendsafelyAPI.csproj @@ -1,4 +1,4 @@ - + Debug @@ -54,6 +54,7 @@ +