C# 调用DHL查询预估运费的rest+json接口

C# 调用DHL查询预估运费的rest+json接口

本文不介绍原理，直接上代码 申请好username和password后开始接入： 首先创建参数实体： ServiceHeader.cs RequestedShipment.cs Packages.cs Billing.cs

测试环境接口：https://wsbexpress.dhl.com/rest/sndpt/RateRequest

private readonly string _baseURL; private readonly string _username; private readonly string _password; public string LastJSONRequest { get; set; } public string LastJSONResponse { get; set; } public string LastHTTPRequest { get; set; } public string LastHTTPResponse { get; set; } public string LastRateQueryJSONRequest { get; set; } public string LastRateQueryJSONResponse { get; set; } public string LastRateQueryHTTPRequest { get; set; } public string LastRateQueryHTTPResponse { get; set; } public string LastShipJSONRequest { get; set; } public string LastShipJSONResponse { get; set; } public string LastShipHTTPRequest { get; set; } public string LastShipHTTPResponse { get; set; } public string LastNewPickupJSONRequest { get; set; } public string LastNewPickupJSONResponse { get; set; } public string LastNewPickupHTTPRequest { get; set; } public string LastNewPickupHTTPResponse { get; set; } public string LastDeletePickupJSONRequest { get; set; } public string LastDeletePickupJSONResponse { get; set; } public string LastDeletePickupHTTPRequest { get; set; } public string LastDeletePickupHTTPResponse { get; set; } public string LastTrackingJSONRequest { get; set; } public string LastTrackingJSONResponse { get; set; } public string LastTrackingHTTPRequest { get; set; } public string LastTrackingHTTPResponse { get; set; } public string LastEPoDJSONRequest { get; set; } public string LastEPoDJSONResponse { get; set; } public string LastEPoDHTTPRequest { get; set; } public string LastEPoDHTTPResponse { get; set; } public myapi(string username, string password, string baseUrl) { this._username = username; this._password = password; this._baseURL = baseUrl; } public RateQueryResponse RateQuery(RateQueryRequest rqr) { List<ValidationResult> list = Common.Validate<RateQueryRequest>(ref rqr); bool flag = list.Any<ValidationResult>(); if (flag) { throw new MyDHLAPIValidationException(list); } this.LastJSONRequest = JsonConvert.SerializeObject(rqr, Formatting.Indented); this.LastRateQueryJSONRequest = this.LastJSONRequest; this.LastJSONResponse = this.SendRequestAndReceiveResponse(this.LastJSONRequest, "RateRequest"); this.LastRateQueryJSONResponse = this.LastJSONResponse; this.LastRateQueryHTTPRequest = this.LastHTTPRequest; this.LastRateQueryHTTPResponse = this.LastHTTPResponse; RateQueryResponse result; try { List<string> errors = new List<string>(); result = JsonConvert.DeserializeObject<RateQueryResponse>(this.LastJSONResponse, new JsonSerializerSettings { Error = delegate (object sender, Newtonsoft.Json.Serialization.ErrorEventArgs args) { errors.Add(args.ErrorContext.Error.Message); args.ErrorContext.Handled = true; } }); } catch { result = new RateQueryResponse(); } return result; } public string SendRequestAndReceiveResponse(string req, string endpoint) { WebRequest webRequest = WebRequest.Create(new Uri(this._baseURL + "/" + endpoint)); webRequest.Credentials = new NetworkCredential(this._username, this._password); webRequest.ContentType = "application/json"; webRequest.PreAuthenticate = true; webRequest.UseDefaultCredentials = false; webRequest.Method = "POST"; string str = Convert.ToBase64String(Encoding.GetEncoding("ISO-8859-1").GetBytes(this._username + ":" + this._password)); webRequest.Headers.Add("Authorization", "Basic " + str); using (StreamWriter streamWriter = new StreamWriter(webRequest.GetRequestStream(), Encoding.UTF8)) { streamWriter.Write(req); streamWriter.Flush(); streamWriter.Close(); } string result = string.Empty; try { WebResponse response = webRequest.GetResponse(); using (StreamReader streamReader = new StreamReader(response.GetResponseStream())) { result = streamReader.ReadToEnd(); } } catch (Exception) { throw; } return result; }

调用方法： private string apiUserName = 申请的username; private string apiPassword = 申请的password; private string apiBaseUrl = “https://wsbexpress.dhl.com/rest/sndpt”;

public string LastJSONResponse { get; private set; } protected void Page_Load(object sender, EventArgs e) { var myDhlApi = new myapi(apiUserName, apiPassword, apiBaseUrl); var resp = myDhlApi.RateQuery(new RateQueryRequest { RateRequest = new RateRequest { Request = new Request { ServiceHeader = new ServiceHeader { MessageReference = "TEST109311111112222222229876", MessageTime = new DateTime(2019, 9, 3, 15, 7, 35), Plugin = "MyDHL API_TEST", PluginVersion = "1.0", ShippingSystemPlatform = "MyDHL API_TEST", ShippingSystemPlatformVersion = "1.0", WebstorePlatform = "MyDHL API_TEST", WebstorePlatformVersion = "1.0" } }, ClientDetails = null, RequestedShipment = new RequestedShipment { DropOffType = Enums.DropOffType.RegularPickup, NextBusinessDay = Enums.YesNo.Yes, Ship = new Ship { Recipient = new MyDHLAPI_REST_Library.Objects.RateQuery.Address { City = "KAARST", CountryCode = "DE", PostalCode = "41564", StreetLines = "Main Street" }, Shipper = new MyDHLAPI_REST_Library.Objects.RateQuery.Address() { City = "Beijing", CountryCode = "CN", PostalCode = "100017", StreetLines = "River House" } }, Packages = new Packages { RequestedPackages = new List<RequestedPackages> { new RequestedPackages { PieceNumber=1, Weight = new Weight{ Value = 10}, Dimensions = new Dimensions{ Height = 1, Length = 3, Width = 2} } } }, ShipTimestamp = new DateTime(2019, 9, 3, 19, 1, 0), UnitOfMeasurement = Enums.UnitOfMeasurement.SI, Content = Enums.ShipmentType.NonDocuments, DeclaredValue = 100, DeclaredValueCurrencyCode = "USD", Billing = new Billing { BillingAccountNumber = "602965196", ShipperAccountNumber = "602965196", ShippingPaymentType = Enums.PaymentTypes.Shipper }, PaymentInfo = Enums.TermsOfTrade.DAP, NetworkTypeCode = Enums.NetworkTypeCode.All, CustomerAgreementInd = Enums.YesNo.No, ValidateReadyTime = Enums.YesNo.No } } }); ; var names = resp; var namesss = JsonConvert.SerializeObject(resp); Response.Write(JsonConvert.SerializeObject(resp)); }

传递的json参数格式： { “RateRequest”: { “ClientDetails”: “”, “Request”: { “ServiceHeader”: { “MessageTime”: “2019-09-03T15:07:35”, “MessageReference”: “TEST109311111112222222229876”, “WebstorePlatform”: “MyDHL API_TEST”, “WebstorePlatformVersion”: “1.0”, “ShippingSystemPlatform”: “MyDHL API_TEST”, “ShippingSystemPlatformVersion”: “1.0”, “PlugIn”: “MyDHL API_TEST”, “PlugInVersion”: “1.0” } }, “RequestedShipment”: { “DropOffType”: “REGULAR_PICKUP”, “NextBusinessDay”: “Y”, “ShipTimestamp”: “2019-09-03T19:01:00 G9T+08:00”, “UnitOfMeasurement”: “SI”, “Content”: “NON_DOCUMENTS”, “DeclaredValue”: 100.0, “DeclaredValueCurrecyCode”: “USD”, “PaymentInfo”: “DAP”, “RequestValueAddedServices”: “N”, “NetworkTypeCode”: “AL”, “CustomerAgreementInd”: “N”, “ValidateReadyTime”: “N”, “Ship”: { “Shipper”: { “StreetLines”: “River House”, “City”: “BEIJING”, “PostalCode”: “100017”, “CountryCode”: “CN” }, “Recipient”: { “StreetLines”: “Main Street”, “City”: “OSNABRUECK”, “PostalCode”: “41564”, “CountryCode”: “DE” } }, “Packages”: { “RequestedPackages”: [{ “@number”: 0, “Weight”: { “Value”: 10.0 }, “Dimensions”: { “Length”: 3.0, “Width”: 2.0, “Height”: 1.0 } }] }, “Billing”: { “ShipperAccountNumber”: “602965196”, “ShippingPaymentType”: “S”, “BillingAccountNumber”: “602965196” }

} }

}

返回的json字符串： { “RateResponse”: { “Provider”: [ { “@code”: “DHL”, “ServiceHeader”: { “MessageTime”: “2020-07-04T10:20:41.094+00:00”, “MessageReference”: “TEST109311111112222222229876”, “ServiceInvocationID”: “20200704102041_b82c_b6c4a0a5-48d4-459f-9c11-073180add382” }, “Notification”: [ { “@code”: “0”, “Message”: null } ], “Service”: { “@type”: “Y”, “TotalNet”: { “Currency”: “CNY”, “Amount”: 2000.81 }, “Charges”: { “Currency”: “CNY”, “Charge”: [ { “ChargeType”: “EXPRESS 12:00”, “ChargeAmount”: 1626.6 }, { “ChargeCode”: “YK”, “ChargeType”: “12:00 PREMIUM”, “ChargeAmount”: 69.0 }, { “ChargeCode”: “FF”, “ChargeType”: “FUEL SURCHARGE”, “ChargeAmount”: 305.21 } ] }, “DeliveryTime”: “2019-09-09T12:00:00”, “CutoffTime”: “2019-09-03T20:00:00”, “NextBusinessDayInd”: “N” } } ] } }

示例代码下载：https://download.csdn.net/download/xmg1314/12576722