Aspose.Email-Cloud 19.12.0

This SDK allows you to work with Aspose.Email Cloud REST APIs in your .NET applications quickly and easily, with zero initial cost.

Aspose.Email Cloud home
API Reference

Key features

Aspose.Email Cloud is a REST API for creating email applications that work with standard email file formats. This SDK:

• Lets developers manipulate different emails’ formats such as Outlook MSG, EML, VCard, and iCalendar files
• Has a built-in email client
• Supports AI functionalities:
  • The Business card recognition
  • The Name API for parsing and handling personal names

How to use the SDK?

The complete source code is available in the GIT repository. Use reference documentation, available here

Prerequisites

To use this SDK, you need:

• One of supported (or compatible with supported) .NET frameworks:
  • .NETFramework 2.0
  • .NETFramework 4.5.2
  • .NETStandard 2.0
  • MonoAndroid 6.0
  • Xamarin.iOS 1.0
  • Xamarin.Mac 2.0
• An App SID and an App Key; they can be looked up at Aspose Cloud Dashboard (it requires free registration in Aspose Cloud for this).

Usage examples

To use the API, you should create an EmailApi object:

using Aspose.Email.Cloud.Sdk.Api; //EmailApi class is here
using Aspose.Email.Cloud.Sdk.Model; //REST API models are here
using Aspose.Email.Cloud.Sdk.Model.Requests; //Request models are here (all API calls use corresponding request model class)

...
var appKey = "Your App Key";
var appSid = "Your App SID";
var emailApi = new EmailApi(appKey, appSid);

API calls can be synchronous or asynchronous (if it's supported by the framework):

var result = emailApi.GetCalendar(new GetCalendarRequest(calendarFile, folder, StorageName));
// or
var result = await emailApi.GetCalendarAsync(new GetCalendarRequest(calendarFile, folder, StorageName));

Some examples are listed below and most of them are available on wiki

Business cards recognition API

Parse images:

//Read image from file and convert it to Base64 string
var bytes = File.ReadAllBytes("some/business/card/image/file/on/disk");
var base64Image = Convert.ToBase64String(bytes);
var result = await emailApi.AiBcrParseAsync(new AiBcrParseRequest(new AiBcrBase64Rq(null,
    new List<AiBcrBase64Image> {new AiBcrBase64Image(true, base64Image)})));
//Result contains all recognized VCard objects (only the one in our case)
var contactProperties = result.Value.First();

//VCard object is available as a list of properties, without any external calls:
var primitiveProperties = contactProperties.InternalProperties
    .Where(property => property is PrimitiveObject)
    .Select(property => property as PrimitiveObject)
    .ToList();
foreach(var primitiveProperty in primitiveProperties)
{
    System.Console.WriteLine($"Property name: {primitiveProperty.Name}, value: {primitiveProperty.Value}");
}

Name API

See examples below: Detect a person's gender by name

var name = "John Cane";
var result = await emailApi.AiNameGenderizeAsync(
    new AiNameGenderizeRequest(name));
// the result contains a list of hypothesis about a person's gender.
// all hypothesis include score, so you can use the most scored version,
// which will be the first in a list:
System.Console.WriteLine(result.Value.First().Gender); //prints "Male"

Format person's name using defined format

var result = await emailApi.AiNameFormatAsync(
    new AiNameFormatRequest(
        "Mr. John Michael Cane",
        format:"%t%L%f%m"));
System.Console.WriteLine(result.Name); //prints "Mr. Cane J. M."

Compare the names to find out if they belong to the same person or not

const string first = "John Michael Cane";
const string second = "Cane J.";
var result = await emailApi.AiNameMatchAsync(
    new AiNameMatchRequest(first, second));
System.Console.WriteLine(result.Similarity > 0.5); //prints "true", names look similar

Resources

• SDK Reference documentation
• Website
• Product Home
• Documentation
• API Reference
• Free Support Forum
• Paid Support Helpdesk
• Blog
• Git repository: Aspose.Email Cloud SDK for .Net
• Git repository: Aspose.Email Cloud SDK for Ruby
• Git repository: Aspose.Email Cloud SDK for Python
• Git repository: Aspose.Email Cloud SDK for PHP
• Git repository: Aspose.Email Cloud SDK for Typescript
• Git repository: Aspose.Email Cloud SDK for Java