ShipEngine 2.3.0
See the version list below for details.
dotnet add package ShipEngine --version 2.3.0
NuGet\Install-Package ShipEngine -Version 2.3.0
<PackageReference Include="ShipEngine" Version="2.3.0" />
paket add ShipEngine --version 2.3.0
#r "nuget: ShipEngine, 2.3.0"
// Install ShipEngine as a Cake Addin #addin nuget:?package=ShipEngine&version=2.3.0 // Install ShipEngine as a Cake Tool #tool nuget:?package=ShipEngine&version=2.3.0
ShipEngine .NET SDK
The official ShipEngine SDK for .NET
Quick Start
Install ShipEngine .NET SDK via the .NET CLI.
dotnet add package ShipEngine
The only configuration requirement is an API key.
using ShipEngineSDK;
var shipengine = new ShipEngine("___YOUR_API_KEY_HERE__");
Methods
CreateLabelFromRate
- When retrieving rates for shipments using theGetRatesWithShipmentDetails
method, the returned information contains aRateId
property that can be used to purchase a label without having to refill in the shipment information repeatedly.CreateLabelFromShipmentDetails
- Purchase and print a label for shipment.GetRatesWithShipmentDetails
- Given some shipment details and rate options, this method returns a list of rate quotes.ListCarriers
- Returns a list of carrier accounts that have been connected through the ShipEngine dashboard.TrackUsingLabelId
- Track a package by its associated label ID.TrackUsingCarrierCodeAndTrackingNumber
- Track a package for a given carrier and tracking number.ValidateAddresses
- Indicates whether the provided addresses are valid. If the addresses are valid, the method returns a normalized version based on the standards of the country in which the address resides. If an address cannot be normalized, an error is returned.VoidLabelWithLabelId
- Void a label with its Label ID.CreateManifests
- Create a shipment manifest.
Contributing
Contributions, enhancements, and bug-fixes are welcome! Open an issue on GitHub and submit a pull request.
Building
To build the project locally on your computer:
Clone this repo<br>
git clone https://github.com/ShipEngine/shipengine-dotnet.git
Install .NET 5.x
Install dependencies<br>
dotnet restore
Build the code<br>
dotnet build
Format the code<br>
dotnet format
Run the tests<br>
dotnet test
<br><br> By default, the test project targets all supported frameworks, if your environment only supports a subset then you can specify in the CLI. <br><br>dotnet test -f net5.0
Generating from OpenAPI
To regenerate the SDK from the OpenAPI spec, you will first need to get the latest version of the spec. It can be downloaded from the online documentation
and should be saved to ./generation/swagger.json
. Then run npm run generate
from the command line. This will regenerate all the API calls and models, but not docs or tests.
The templates for autogeneration were extracted using the command:
npx @openapitools/openapi-generator-cli author template -g csharp -o generation/templates
Release
Create a fork for your changes.
Update the Changelog with any relevant new features or bug fixes and modify the packageVersion
property in the .openapitools.json
file to match the new version.
In the ShipEngine.csproj
file, update to the desired version (using semantic versioning) and push to your fork.
Run dotnet format
Create a pull request.
Once a member of the ShipEngine team reviews your PR and it's merged to main, the build pipeline will handle all the necessary github tags and nuget packaging and publishing.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- Macross.Json.Extensions (>= 3.0.0)
- Microsoft.Extensions.DependencyInjection (>= 8.0.0)
- Microsoft.Extensions.Hosting (>= 8.0.0)
- Microsoft.Extensions.Http (>= 8.0.0)
- System.Text.Json (>= 8.0.4)
NuGet packages (2)
Showing the top 2 NuGet packages that depend on ShipEngine:
Package | Downloads |
---|---|
Apsy.Elemental.ECommerce
Package Description |
|
Apsy.Elemental.ShippingAddress
Package Description |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
3.0.0-beta.16 | 134 | 2 months ago |
3.0.0-beta.15 | 775 | 2 months ago |
3.0.0-beta.14 | 49 | 3 months ago |
3.0.0-beta.13 | 158 | 3 months ago |
3.0.0-beta.12 | 965 | 3 months ago |
3.0.0-beta.11 | 509 | 4 months ago |
3.0.0-beta.10 | 48 | 4 months ago |
3.0.0-beta.9 | 931 | 5 months ago |
3.0.0-beta.8 | 78 | 5 months ago |
3.0.0-beta.7 | 49 | 5 months ago |
3.0.0-beta.6 | 108 | 5 months ago |
3.0.0-beta.5 | 81 | 5 months ago |
3.0.0-beta.4 | 83 | 5 months ago |
3.0.0-beta.3 | 70 | 5 months ago |
3.0.0-beta.2 | 74 | 5 months ago |
3.0.0-beta.1 | 57 | 5 months ago |
2.3.4 | 160 | a month ago |
2.3.3 | 1,178 | 2 months ago |
2.3.2 | 1,766 | 3 months ago |
2.3.1 | 112 | 4 months ago |
2.3.0 | 121 | 4 months ago |
2.2.1 | 2,924 | 5 months ago |
2.2.0 | 112 | 5 months ago |
2.0.5 | 113 | 5 months ago |
2.0.4 | 1,084 | 6 months ago |
2.0.3 | 170 | 6 months ago |
2.0.2 | 115 | 6 months ago |
2.0.1 | 142 | 6 months ago |
2.0.0 | 1,802 | 7 months ago |
1.1.9 | 3,236 | 7 months ago |
1.1.8 | 20,210 | 8 months ago |
1.1.7 | 124 | 8 months ago |
1.1.6 | 531 | 9 months ago |
1.1.5 | 1,955 | 1/12/2024 |
1.1.3 | 2,555 | 10/3/2023 |
1.1.2 | 175 | 9/18/2023 |
1.1.1 | 5,157 | 8/7/2023 |
1.1.0 | 4,721 | 11/10/2022 |
1.0.7 | 2,582 | 11/1/2022 |
1.0.6 | 795 | 10/19/2022 |
1.0.5 | 594 | 9/23/2022 |
1.0.4 | 718 | 6/9/2022 |