使用Azure DevOps REST API创建Classification Nodes时出现415错误

核心原因 #

415状态码表示媒体类型不被服务器支持，这是Azure DevOps REST API POST/PUT请求中最常见的问题之一——即使请求体格式正确，缺少指定的Content-Type头会导致服务器无法解析请求内容，进而抛出内部错误。

解决步骤 #

1. 添加正确的请求头
   必须在请求中包含Content-Type: application/json头，这是API解析JSON请求体的必要条件。

2. 验证请求体格式
   确认请求体是合法的JSON格式，你的示例{"name": "Very nice area"}格式没问题，但要避免多余逗号、引号不匹配等语法错误。

3. 检查权限配置
   确保用于请求的凭据（比如个人访问令牌PAT）拥有Work Item Tracking的Write权限，虽然其他API正常，但分类节点的修改需要明确的写入权限。

4. 示例请求（Curl）

   curl -X POST \
     https://dev.azure.com/{organisation}/{project}/_apis/wit/classificationnodes/Areas?api-version=7.1-preview.2 \
     -H "Content-Type: application/json" \
     -H "Authorization: Basic {你的PAT Base64编码}" \
     -d '{"name": "Very nice area"}'
   

额外排查建议 #

如果添加请求头后仍报错，可使用Azure DevOps门户内置的API测试工具发起请求，排除客户端工具（如Postman、自定义脚本）的配置问题。

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