如何在APIM中为同一服务创建OData与HTTP两个API？

1. 新建OData专用API #

• 在APIM控制台创建新API时，选择OData类型，后端基础URL填https://<myurl>/<myservice>/odata，匹配你后端的OData版本（比如v4）。
• 利用APIM的自动导入功能，通过后端的$metadata元数据文件直接导入所有OData实体和操作，自动生成对应的API路径和操作，省去手动配置的麻烦。

2. 收缩原有HTTP API的处理范围 #

• 原有HTTP API的基础URL保留https://<myurl>/<myservice>，但要做路径隔离：在API的路径配置里，设置路径匹配规则为/*，同时添加排除规则/odata/*，这样APIM会自动把/odata开头的请求导向新的OData API。
• 迁移策略：把原有HTTP API里属于OData的策略（比如OData参数校验、特定权限控制）移到新OData API的全局或操作级策略里；通用策略（比如认证、日志）可以抽成APIM的策略片段，两个API直接引用即可，避免重复编写代码。

3. 路由兜底配置（可选） #

如果担心路径匹配规则未生效，可以在原有HTTP API的入站策略里添加一段判断，强制将/odata请求转发到新OData API：

<choose>
    <when condition="@(context.Request.Path.StartsWithSegments("/odata"))">
        <set-backend-service base-url="https://<你的APIM实例域名>.azure-api.net/你的ODataAPI名称" />
        <rewrite-uri template="@(context.Request.Path.ToString().Substring(6))" /> <!-- 去掉开头的/odata，避免路径重复 -->
    </when>
</choose>

4. 验证与测试 #

• 分别测试OData请求（比如GET /odata/Products?$top=10）和普通API请求（比如POST /xxxx/create），确认流量正确路由到对应API，策略正常执行。
• 检查后端服务日志，确保请求路径没有出现重复（比如避免生成/odata/odata/Products这类错误路径）。

优化建议 #

• 用策略片段管理通用逻辑（比如JWT验证、请求日志），两个API直接引用，减少后续维护成本。
• 给两个API分配不同的APIM产品，方便单独设置配额、限流或权限规则。
• 开启APIM诊断日志，监控两个API的流量和错误，快速定位问题。

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