如何在Apigee GET API中传递特殊符号参数及禁用编解码

嘿，这些都是Apigee做SOAP转REST时很常见的问题，我来给你一一梳理解决方案：

1. 如何在Apigee中停止特殊符号的编解码操作？ #

Apigee默认会对请求参数做URL编解码处理，要阻止这个行为，得从入站和出站两个流入手：

• 入站请求（客户端→Apigee）：
  打开你的ProxyEndpoint配置，检查<Request>区块里是否有默认的<URLDecode>政策，如果有，直接移除它。或者添加一个<AssignMessage>政策，直接将原始查询参数赋值到变量中，绕开自动解码逻辑。比如：

  <AssignMessage name="AM-PreserveRawParam">
    <AssignTo createNew="false" type="request"/>
    <AssignVariable>
      <Name>raw_param_value</Name>
      <Value>{request.queryparam.your_special_param}</Value>
    </AssignVariable>
  </AssignMessage>
  

  这个变量raw_param_value会保留参数的原始值，不会被Apigee自动修改。

• 出站请求（Apigee→SOAP服务）：
  在TargetEndpoint的PreFlow里，不要依赖Apigee自动生成SOAP请求参数，而是手动构造请求体。可以用JavaScript政策直接获取原始参数值，插入到SOAP XML中：

  var specialParam = context.getVariable('request.queryparam.your_special_param');
  var soapBody = '<soapenv:Envelope>...<param>' + specialParam + '</param>...</soapenv:Envelope>';
  context.setVariable('request.content', soapBody);
  

  同时检查是否有<URLEncode>政策被误加在出站流里，有的话直接删除。

• 额外检查：查看所有Flow里的政策，确保没有强制编解码的URLEncode/URLDecode政策在运行，这些都会修改参数值。

2. Apigee的同类免费替代服务 #

如果Apigee的付费方案对你来说有点重，这些开源免费的API网关都能实现SOAP转REST的需求：

• Kong Community Edition：老牌开源API网关，社区活跃，支持SOAP转REST、请求转换、参数自定义处理，完全免费，适合各种规模的项目。
• Apache APISIX：高性能云原生网关，自带丰富的插件体系，能轻松实现SOAP到REST的协议转换，参数编解码逻辑可自定义。
• Tyk Community Edition：轻量型开源网关，配置简单，支持API转换和参数处理，核心功能免费，适合中小型团队快速搭建网关。
• Express Gateway：基于Node.js的开源网关，灵活性极强，通过自定义插件就能实现SOAP转REST，参数处理逻辑完全由你掌控。

3. 如何在Apigee的GET API请求中传递如\/、|这类特殊符号的参数？ #

要安全传递这些特殊符号，得分客户端发送和Apigee内部处理两个环节：

• 客户端发送请求时：
  这些符号属于URL保留字符，客户端需要先对它们做正确的URL编码再发送：

  • | 编码后是 %7C
  • / 编码后是 %2F
    发送编码后的参数，比如https://your-apigee-proxy.com/api?param=%7Ctest%2Fvalue，Apigee如果没有二次编码，就能解析出原始的|test/value。

• Apigee内部传递到SOAP服务时：
  确保在构造SOAP请求时，直接使用未被编码的参数值。比如用<AssignMessage>政策构造SOAP体时，直接引用原始参数变量：

  <AssignMessage name="AM-BuildSOAPRequest">
    <Set>
      <Payload contentType="text/xml">
        <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
          <soapenv:Body>
            <YourSOAPMethod>
              <YourParam>{request.queryparam.your_special_param}</YourParam>
            </YourSOAPMethod>
          </soapenv:Body>
        </soapenv:Envelope>
      </Payload>
    </Set>
    <AssignTo createNew="false" type="request"/>
  </AssignMessage>
  

  这样就能把特殊符号原样传递给后端SOAP服务。

• 终极技巧：如果担心Apigee的默认处理逻辑干扰，可以用JavaScript政策直接获取原始查询字符串，自己解析参数：

  var rawQuery = context.getVariable('request.querystring');
  // 手动解析rawQuery，提取你需要的参数值
  

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