使用C# REST API在Azure ADO中创建服务挂钩订阅失败求助

尝试为Azure DevOps的Workitem Created事件创建Service Hook/Webhook订阅，操作失败，收到错误：StatusCode: 203, ReasonPhrase: 'Non-Authoritative Information'。使用的是拥有完全权限的个人访问令牌（PAT）进行认证，相关信息及代码如下：

相关地址 #

• Azure Function地址：https://function-xxxxxxxx-syncxxxxxxxx-v1.azurewebsites.net/api/CreateWorkItem?code=M4bvxxxxxxxxxxxxxxx
• 请求URL：https://dev.azure.com/TestOrg/TestProject/_apis/hooks/subscriptions?api-version=7.0
• 事件类型：workitem.created

代码实现 #

var subscription = new
{
    publisherId = "tfs",
    eventType = workItemType,
    resourceVersion = "1.0",
    consumerId = "webHooks",
    consumerActionId = "httpRequest",
    consumerInputs = new
    {
        url = urlType
    }
};

var subscriptionJson = JsonConvert.SerializeObject(subscription);
var content = new StringContent(subscriptionJson, System.Text.Encoding.UTF8, "application/json");

requestUri = $"{baseUrl + orga}/{project}/_apis/hooks/subscriptions?api-version=7.0";

using (HttpClient client = new HttpClient())
{                    
    client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
    client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", personalAccessToken); // personalAccessToken拥有完全权限
    var response = await client.PostAsync(requestUri, content);
    response.EnsureSuccessStatusCode();
    var responseContent = await response.Content.ReadAsStringAsync();
    var createdSubscription = JsonConvert.DeserializeObject<dynamic>(responseContent);
    Console.WriteLine($"Service hook subscription created. Subscription ID: {createdSubscription.id}");
}

排查与解决建议 #

1. 检查PAT的编码格式
   203错误常和认证头格式问题有关。Basic认证要求PAT需按:{原始PAT}的格式拼接后，再做Base64编码。确认你的personalAccessToken变量是否是Convert.ToBase64String(Encoding.ASCII.GetBytes($":{原始PAT}"))的结果，而非直接使用原始PAT或错误编码的值。

2. 验证Azure Function的可达性
   Azure DevOps创建订阅时会验证Webhook地址的可用性。直接访问你的Azure Function地址，确认它能返回200类成功状态码。如果Function返回非200状态，或存在防火墙/网络限制导致Azure DevOps无法访问，会触发这类错误。

3. 检查请求URL的拼接正确性
   确认baseUrl + orga的拼接无问题，最终的requestUri需是完整的https://dev.azure.com/TestOrg/TestProject/_apis/hooks/subscriptions?api-version=7.0，避免出现多余斜杠或缺失部分的情况。

4. 添加详细错误日志
   在代码中捕获HttpRequestException并打印响应内容，Azure DevOps通常会在响应里给出具体错误原因（比如权限不足、地址验证失败等）。修改后的代码片段：

   try
   {
       var response = await client.PostAsync(requestUri, content);
       response.EnsureSuccessStatusCode();
       // 后续逻辑...
   }
   catch (HttpRequestException ex)
   {
       var errorContent = await response.Content.ReadAsStringAsync();
       Console.WriteLine($"错误详情: {errorContent}");
       throw;
   }
   

5. 确认PAT的权限范围
   即便PAT标注为完全权限，仍建议确认是否勾选了Service Hooks的读写权限（在PAT创建页面的Code分类下），同时检查PAT所属账号是否拥有目标项目的管理员权限，避免配置疏漏。

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