如何在Postman Body中向.NET API传递硬编码GUID

1. URL路径参数（如API路由为 /api/items/{id1}/{id2}） #

直接在URL中填入标准格式的GUID字符串，无需额外引号：
https://your-api-url/api/items/3fa85f64-5717-4562-b3fc-2c963f66afa6/7b9e8d7c-1234-5678-90ab-cdef01234567

对应.NET控制器方法需确保参数绑定正确：

[HttpGet("api/items/{id1}/{id2}")]
public IActionResult GetItems(Guid id1, Guid id2)
{
    // 业务逻辑
}

2. URL查询参数（如API路由为 /api/items，参数附在URL末尾） #

在Postman的「Params」标签中填写键值对，值为标准GUID字符串，无需引号：

• 键：id1，值：3fa85f64-5717-4562-b3fc-2c963f66afa6
• 键：id2，值：7b9e8d7c-1234-5678-90ab-cdef01234567

对应.NET方法：

[HttpGet("api/items")]
public IActionResult GetItems([FromQuery] Guid id1, [FromQuery] Guid id2)
{
    // 业务逻辑
}

3. 请求体（JSON格式，POST/PUT请求） #

在Postman的「Body」标签选择「raw」并设置格式为「JSON」，按标准JSON语法传递GUID（字符串需加双引号）：

{
    "id1": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "id2": "7b9e8d7c-1234-5678-90ab-cdef01234567"
}

对应.NET模型类：

public class ItemRequest
{
    public Guid Id1 { get; set; }
    public Guid Id2 { get; set; }
}

控制器方法：

[HttpPost("api/items")]
public IActionResult CreateItem([FromBody] ItemRequest request)
{
    // 业务逻辑
}

常见避坑点 #

• URL参数中不要给GUID加任何引号；JSON请求体中必须用双引号包裹GUID字符串
• 确保GUID格式合规：遵循xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx的8-4-4-4-12十六进制结构
• 检查.NET端参数的绑定特性（[FromQuery]/[FromRoute]/[FromBody]）需和Postman的传递方式匹配

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