The documentation here is incorrect.
The only thing worse than missing documentation is incorrect documentation.
I need to calculate rates for a shipment. I want rates for multiple carriers for a number of services. I can do this with your raw REST API. I can't for the life of me figure out how to do it with your .NET API, though.
Four years ago, when I needed to write an integration for ShipEngine, I wrote my own because of issues with your .NET API. Your API has matured and is much improved, or so I thought until I tried to write code to get a collection of quotes.
The first thing your documentation shows is this:
var calculateRatesRequestBody = new CalculateRatesRequestBody();
That class has no default constructor. The available constructors either want a RateShipmentRequest or RateIdRequest.
So if I create a RateShipmentRequest, it has a property called Shipment. However, Shipment is a AddressValidatingShipment. It requires a carrier ID and service code. That's clearly not the way to get a collection of quotes!
Using RateIdRequest is even more wrong, since it only takes a shipment ID and no other information. Do I have to create a shipment before?
Why did you deprecate GetRatesWithShipmentDetails() that clearly does do what we need?
I want to use your .NET SDK, but this is making it really hard. How is anyone using your .NET SDK unless I'm massively misunderstanding something?
The documentation here is incorrect.
The only thing worse than missing documentation is incorrect documentation.
I need to calculate rates for a shipment. I want rates for multiple carriers for a number of services. I can do this with your raw REST API. I can't for the life of me figure out how to do it with your .NET API, though.
Four years ago, when I needed to write an integration for ShipEngine, I wrote my own because of issues with your .NET API. Your API has matured and is much improved, or so I thought until I tried to write code to get a collection of quotes.
The first thing your documentation shows is this:
That class has no default constructor. The available constructors either want a
RateShipmentRequestorRateIdRequest.So if I create a
RateShipmentRequest, it has a property calledShipment. However,Shipmentis aAddressValidatingShipment. It requires a carrier ID and service code. That's clearly not the way to get a collection of quotes!Using
RateIdRequestis even more wrong, since it only takes a shipment ID and no other information. Do I have to create a shipment before?Why did you deprecate
GetRatesWithShipmentDetails()that clearly does do what we need?I want to use your .NET SDK, but this is making it really hard. How is anyone using your .NET SDK unless I'm massively misunderstanding something?