在企業系統整合情境中,常需主動將資料以 HTTP POST 方式推送至第三方 API。本文示範在 ASP.NET (C#) 中使用 HttpWebRequest 組裝 XML 承載、設定標頭、處理串流與回應的完整流程,並說明 MemoryStream 替代 Stream 避免長度不可搜尋的常見坑點。
<appSettings>
<add key="PushApiUrl" value="https://api.partner.com/receive" />
</appSettings>
using System;
using System.IO;
using System.Net;
using System.Text;
using System.Web;
using System.Xml.Linq;
public class PushService
{
private readonly string _apiUrl;
public PushService()
{
_apiUrl = System.Configuration.ConfigurationManager.AppSettings["PushApiUrl"];
}
///
/// 將消費紀錄以 XML 格式 POST 推送至外部 API
///
public string PushConsumption(ConsumptionRecord consumption)
{
// 1. 組裝 XML 承載
string xmlBody = $@"<?xml version=\"1.0\" encoding=\"UTF-8\"?>
<Body>
<ValidId>{consumption.Id}</ValidId>
<OrderId>{consumption.Order.AgentOrderId}</OrderId>
<Count>{consumption.Count}</Count>
<ValidTime>{consumption.CreateTime:yyyy-MM-dd HH:mm:ss}</ValidTime>
<Remark/>
</Body>";
string requestXml = BuildRequestEnvelope(xmlBody);
// 2. 建立 HttpWebRequest
HttpWebRequest request = (HttpWebRequest)WebRequest.Create(_apiUrl);
request.Method = "POST";
request.Headers.Add("X-Auth-Token", HttpUtility.UrlEncode("openstack"));
request.ContentType = "application/xml"; // 依實際 API 調整
request.AllowAutoRedirect = true;
// 3. 寫入請求串流:使用 MemoryStream 避免 Stream 不支援 Length/Position
byte[] payloadBytes = Encoding.UTF8.GetBytes(requestXml);
using (MemoryStream memStream = new MemoryStream())
{
memStream.Write(payloadBytes, 0, payloadBytes.Length);
request.ContentLength = memStream.Length;
using (Stream reqStream = request.GetRequestStream())
{
memStream.Position = 0;
memStream.CopyTo(reqStream);
}
}
// 4. 取得回應並處理編碼
using (HttpWebResponse response = (HttpWebResponse)request.GetResponse())
using (Stream respStream = response.GetResponseStream())
using (StreamReader reader = new StreamReader(respStream, Encoding.GetEncoding("UTF-8"), true))
{
string rawResponse = reader.ReadToEnd();
// 若回應為 Base64 加密的 XML,需解密解析
return ProcessResponse(rawResponse);
}
}
private string BuildRequestEnvelope(string bodyXml)
{
// 依對方規格包裝 SOAP 或自訂信封,此處略
return bodyXml;
}
private string ProcessResponse(string raw)
{
// 範例:解密、解析 XML、提取 UseId
// string decrypted = TCodeServiceCrypt.Decrypt3DESFromBase64(...);
// XDocument doc = XDocument.Parse(decrypted);
// return doc.Element("Body").Element("UseId").Value;
return raw; // 簡化
}
}
public class ConsumptionRecord
{
public int Id { get; set; }
public OrderInfo Order { get; set; }
public int Count { get; set; }
public DateTime CreateTime { get; set; }
}
public class OrderInfo
{
public string AgentOrderId { get; set; }
}
直接使用 request.GetRequestStream() 取得的 Stream 不支援 Length 與 Position 屬性,導致無法預先設定 ContentLength 或重設位置。MemoryStream 完整支援搜尋操作,寫入後再 CopyTo 至請求串流即可。
Encoding.UTF8.GetBytes 產生 Byte 陣列。StreamReader 指定 Encoding.UTF8 讀取,避免預設 Default 編碼導致中文亂碼。ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12;request.Timeout 與 request.ReadWriteTimeout 防止卡死。HttpClient ( .NET 4.5+ ) 簡化非同步與連線池管理。public async Task<string> PushConsumptionAsync(ConsumptionRecord consumption)
{
string xmlBody = BuildXmlBody(consumption);
using (HttpClient client = new HttpClient())
{
client.DefaultRequestHeaders.Add("X-Auth-Token", "openstack");
HttpContent content = new StringContent(xmlBody, Encoding.UTF8, "application/xml");
HttpResponseMessage resp = await client.PostAsync(_apiUrl, content);
resp.EnsureSuccessStatusCode();
return await resp.Content.ReadAsStringAsync();
}
}