Azure API Management：如何提取Azure DevOps工作项ID作为响应

你遇到的问题核心是错误地在<send-request>环节直接修改响应体，或是重复读取响应流导致的异常。正确的做法是先将Azure Boards的响应存入变量，再在出站策略中提取工作项ID作为最终响应。

正确的策略配置示例 #

<policies>
    <inbound>
        <!-- 调用Azure Boards创建工作项，将响应存入变量 -->
        <send-request mode="new" response-variable-name="workItemCreateResponse" timeout="30" ignore-error="false">
            <set-url>https://dev.azure.com/{你的组织名}/{项目名}/_apis/wit/workitems/$Bug?api-version=7.1-preview.3</set-url>
            <set-method>POST</set-method>
            <set-header name="Content-Type" exists-action="override">
                <value>application/json-patch+json</value>
            </set-header>
            <set-header name="Authorization" exists-action="override">
                <value>Basic {你的PAT Base64编码}</value>
            </set-header>
            <set-body>
                <value>[
                    {
                        "op": "add",
                        "path": "/fields/System.Title",
                        "value": "@(context.Request.Body.As<string>())"
                    }
                ]</value>
            </set-body>
        </send-request>
        <!-- 跳过默认后端调用，避免无效请求 -->
        <set-backend-service base-url="https://dummy.invalid" />
        <rewrite-uri template="/" />
    </inbound>
    <backend>
        <forward-request />
    </backend>
    <outbound>
        <!-- 从变量提取工作项ID，构造最终响应 -->
        <set-body>@{
            var createResponse = (IResponse)context.Variables["workItemCreateResponse"];
            var responseJson = createResponse.Body.As<JToken>();
            var workItemId = responseJson["id"].ToString();
            return $"{{\"workItemId\": {workItemId}}}";
        }</set-body>
        <!-- 设置正确的响应内容类型 -->
        <set-header name="Content-Type" exists-action="override">
            <value>application/json</value>
        </set-header>
        <!-- 移除不必要的响应头 -->
        <remove-header name="Transfer-Encoding" />
    </outbound>
    <on-error>
        <!-- 错误处理，返回清晰的错误信息 -->
        <set-status code="@((int)context.LastError.StatusCode)" reason="@context.LastError.Message" />
        <set-body>@{
            return Newtonsoft.Json.JsonConvert.SerializeObject(new {
                error = context.LastError.Message,
                details = context.LastError.Details
            });
        }</set-body>
    </on-error>
</policies>

关键注意事项 #

• 不要直接在<send-request>中修改响应体，而是通过response-variable-name把响应存入变量，后续在<outbound>环节处理。
• 必须跳过默认后端调用（设置一个无效的base-url），否则APIM会尝试转发原始请求到默认后端，引发额外错误。
• 避免直接操作context.Response.Body，因为它是一次性可读流，重复读取会导致流已关闭的异常，这是你之前遇到500错误的主要原因。
• 加入错误处理策略，方便排查调用Azure Boards时可能出现的权限、参数错误。

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