Azure API Management中POST参数转XML请求体及凭证注入方法

嘿，这两个Azure APIM的需求都能通过内置的入站策略轻松解决，我给你详细拆解下：

首先得明确你的输入参数是URL查询参数还是表单参数，APIM里都能通过context.Request对象直接获取，然后用set-body策略生成目标XML。

举个实际例子：假设你的POST请求带了username和email两个查询参数，要转换成如下XML作为请求体：

<UserInfo>
  <Username>xxx</Username>
  <Email>xxx</Email>
</UserInfo>

你可以在API的入站策略中添加这段代码：

<set-body>@{
    // 获取查询参数，要是表单参数就换成context.Request.Form.Get("username")
    var username = context.Request.Query.Get("username");
    var email = context.Request.Query.Get("email");
    
    // 拼接XML，务必用SecurityElement.Escape转义特殊字符，避免XML格式错误
    return $@"
<UserInfo>
  <Username>{System.Security.SecurityElement.Escape(username)}</Username>
  <Email>{System.Security.SecurityElement.Escape(email)}</Email>
</UserInfo>";
}</set-body>

几个关键注意点：

• 一定要转义XML特殊字符（比如&、<、>），不然会导致请求体格式无效
• 如果参数多或者XML结构复杂，用Liquid模板会更易维护，先定义XML模板再传入参数渲染
• 表单参数和查询参数的获取方式仅差一个对象（Query vs Form），按需切换即可

这个场景是你原本有固定结构的XML模板，现在要把外部传入的凭证参数（比如apiKey、secret）替换进去，最灵活的方式是用Liquid模板配合set-body策略，步骤如下：

步骤1：准备带占位符的XML模板 #

把原XML中需要替换的凭证字段改成Liquid占位符，比如：

<AuthRequest>
  <Credentials>
    <ApiKey>{{apiKey}}</ApiKey>
    <Secret>{{secret}}</Secret>
  </Credentials>
  <!-- 这里保留你原本的其他XML内容 -->
</AuthRequest>

步骤2：在APIM入站策略中配置转换 #

先获取请求参数，再用Liquid模板渲染最终XML：

<!-- 先把请求参数存到变量里，方便后续调用 -->
<set-variable name="apiKey" value="@(context.Request.Query.Get("apiKey"))" />
<set-variable name="secret" value="@(context.Request.Query.Get("secret"))" />

<!-- 用Liquid模板渲染XML请求体 -->
<set-body template="liquid">
<AuthRequest>
  <Credentials>
    <ApiKey>{{context.Variables["apiKey"]}}</ApiKey>
    <Secret>{{context.Variables["secret"]}}</Secret>
  </Credentials>
  <!-- 这里复制你原本的XML其他固定内容 -->
</AuthRequest>
</set-body>

备选方案：修改现有XML请求体 #

如果你的请求体已经是XML，但需要替换其中的凭证节点，可以通过XML转JSON修改再转回来的方式：

<!-- 先把XML转成JSON，方便修改节点 -->
<xml-to-json kind="direct" apply="always" consider-accept-header="false" />
<set-body>@{
    var jsonObj = JObject.Parse(context.Request.Body.As<string>());
    // 替换指定节点，这里的JSON路径要对应你的XML结构
    jsonObj["AuthRequest"]["Credentials"]["ApiKey"] = context.Request.Query.Get("apiKey");
    jsonObj["AuthRequest"]["Credentials"]["Secret"] = context.Request.Query.Get("secret");
    return jsonObj.ToString();
}</set-body>
<!-- 再把修改后的JSON转回XML -->
<json-to-xml apply="always" consider-content-type-header="false" />

要点总结：

• Liquid模板适合固定结构的XML，代码更简洁易读
• XML转JSON的方式更适合原XML结构不固定的场景
• 同样要注意参数的转义，避免破坏XML的合法性

内容的提问来源于stack exchange，提问作者ravi