EasyPost Async is a simple shipping API using the .net 4.5 Task Async API. You can sign up for an account at https://easypost.com
Up-to-date documentation at: https://www.easypost.com/docs/api/csharp
NOTE! The NuGet package is not yet developed...
The easiest way to add EasyPost Async to your project is with the NuGet package manager.
Install-Package EasyPost-Async
See NuGet docs for instructions on installing via the dialog or the console.
The EasyPost Async API consists of many object types. There are several attributes that are consistent across all objects:
Id-- Guaranteed unique identifier of the object.CreatedAt/UpdatedAt-- Timestamps of creation and last update time.
The EasyPost Async API is initialized using your API key via the EasyPostClient class. The EasyPostClient class exposes all the functions of the API via a single IEasyPostClient interface that is fully mockable for unit testing.
using EasyPost;
var client = new EasyPostClient("ApiKey");Error handling for task based Async operations is different than normal operations due to differences in how exception handling works. For this reason the EasyPost Async library does not throw exceptions on error but rather relies on the caller examining the RequestError field of the response. This is filled in with details about the error:
using EasyPost;
var address = _client.GetAddress("not-an-id").Result;
if (address.RequestError != null) {
var requestError = address.RequestError;
var statusCode = requestError.StatusCode;
var errorCode = requestError.Code;
var errorMessage = requestError.Message;
var errorList = requestError.Errors;
}An Address can be verified using one or many verifications methods. If Address is created without strict verifications the object will still be created, otherwise an HttpException will be raised.
using EasyPost;
var address = new Address {
Company = "Simpler Postage Inc",
Street1 = "164 Townsend Street",
Street2 = "Unit 1",
City = "San Francisco",
State = "CA",
Country = "US",
Zip = "94107",
};
var address = client.CreateAddress(address, VerificationFlags.Delivery);
if (address.Verifications.Delivery.Success) {
// successful verification
} else {
// unsuccessful verification
}using EasyPost;
Address address = new Address {
C1ompany = "Simpler Postage Inc",
Street1 = "164 Townsend Street",
Street2 = "Unit 1",
City = "San Francisco",
State = "CA",
Country = "US",
Zip = "94107",
};
var address = client.CreateAddress(address, VerificationFlags.DeliveryStrict);
if (address.RequestError != null) {
// unsuccessful verification
}
// successful verificationRating is available through the Shipment object. Since we do not charge for rating there are rate limits for this action if you do not eventually purchase the Shipment. Please contact us at [email protected] if you have any questions.
var fromAddress = new Address { Zip = "14534" };
var toAddress = new Address { Zip = "94107" };
var parcel = new Parcel {
Length = 8,
Width = 6,
Height = 5,
Weight = 10
};
var shipment = new Shipment {
FromAddress = fromAddress,
ToAddress = toAddress,
Parcel = parcel
};
shipment = client.CreateShipment(shipment);
foreach (var rate in shipment.Rates) {
// process rates
}Postage Label Generation
Purchasing a shipment will generate a PostageLabel and any customs Forms that are needed for shipping.
var fromAddress = new Address { Id = "adr_..." };
var toAddress = new Address {
Company = "EasyPost",
Street1 = "164 Townsend Street",
Street2 = "Unit 1",
City = "San Francisco",
State = "CA",
Country = "US",
Zip = "94107"
};
var parcel = new Parcel {
Length = 8,
Width = 6,
Height = 5,
Weight = 10
};
var item = new CustomsItem { Description = "description" };
var info = new CustomsInfo {
CustomsCertify = "TRUE",
EelPfc = "NOEEI 30.37(a)",
CustomsItems = new List<CustomsItem> { item }
};
var options = new Options { Label_format = "PDF" };
var shipment = new Shipment {
FromAddress = fromAddress,
ToAddress = toAddress,
Parcel = parcel,
CustomsInfo = info,
Options = options
};
shipment = client.BuyShipment(shipment.Id, shipment.LowestRate(
includeServices: new[] { Service.Priority },
excludeCarriers: new[] { Carrier.USPS }
));
shipment.PostageLabel.Url; // https://easypost-files.s3-us-west-2.amazonaws.com/files/postage_label/20160826/8e77c397d47b4d088f1c684b7acd802a.png
foreach (var form in shipment.Forms) {
// process forms
}The Batch object allows you to perform operations on multiple Shipments at once. This includes scheduling a Pickup, creating a ScanForm and consolidating labels. Operations performed on a Batch are asynchronous and take advantage of our webhoook infrastructure.
using EasyPost;
var shipment = new Shipment {
FromAddress = fromAddress,
ToAddress = toAddress,
Parcel = parcel,
Options = options
};
var batch = client.CreateBatch(new[] { _testBatchShipment }, "MyReference");This will produce two webhooks. One batch.Created and one batch.Updated. Process each Batch state according to your business logic.
using EasyPost;
var batch = client.GetBatch(batch.Id);
batch = _client.GenerateLabelForBatch(batch.Id, "zpl"); // populates batch.label_url asynchronouslyConsume the subsequent batch.Updated webhook to process further.
If you have an issue with the client feel free to open an issue on GitHub. If you have a general shipping question or a questions about EasyPost's service please contact [email protected] for additional assitance.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent