minimal api 要求 .net 6+，路由注册须在 builder.build() 后、app.run() 前，参数绑定依赖名称与类型而非特性，返回值必须用 results.*() 或 iresult 实现。
Minimal API 必须用 .NET 6+，低于这个版本连 MapGet 都找不到——不是写法错，是根本没那个类型。
创建项目前先确认目标框架
执行 dotnet new web -n MyApi 生成的项目默认是 .NET 8（或最新 LTS），但如果你从旧项目升级、或手动改过 .csproj，务必检查 <targetframework></targetframework> 值是否为 net6.0 及以上。常见翻车点：
- VS 新建时选了 ".NET 5 Web API" 模板，之后只改了
.csproj却没清缓存 → 执行dotnet clean && dotnet build - 多目标框架（如
net6.0;net8.0）下，某些绑定行为不一致，建议单目标开发 - CI/CD 环境 SDK 版本低于项目要求 → 查
dotnet --list-sdks，装对应 SDK
Program.cs 里写路由的顺序不能乱
WebApplication.CreateBuilder → 服务注册 → builder.Build() → 中间件和 MapXxx → app.Run()，这五步缺一不可，且顺序固定。最容易踩的坑：
-
app.MapGet("/test", () => "ok")写在app.Run()后面 → 启动不报错，但所有接口 404 - 在
builder.Build()前调用app.MapGet→ 编译失败，提示app未声明 - 把
app.UseHttpsRedirection()放在app.MapGet后面 → HTTPS 重定向对 API 路由不生效
参数绑定靠类型和名字推断，不是靠特性
Minimal API 不认 [FromQuery]、[FromBody]，它根据参数名是否匹配路由占位符、类型是否为简单类型来决定数据来源：
-
app.MapGet("/user/{id}", (int id) => ...)：路径参数，名字必须是id（大小写敏感） -
app.MapGet("/search", (string q, int page = 1) => ...)：查询参数，q来自?q=abc，page有默认值 -
app.MapPost("/order", (Order req) => ...)：自动尝试 JSON 反序列化，请求头必须含Content-Type: application/json - 发
application/x-www-form-urlencoded却期望绑定到Order→ 直接 400，Minimal API 默认不解析表单
返回值必须用 Results.*() 或实现 IResult
不能直接 return new { ok = true }，否则编译失败或返回空响应。正确姿势：
-
Results.Ok(new { Id = 123 })→ 200 + JSON -
Results.Created($"/api/users/{id}", user)→ 201 + Location header + body -
Results.BadRequest("Missing name")→ 400 + 文本 - 想返回 XML 或自定义格式？得自己实现
IResult，Results.*()工厂方法只覆盖常用 HTTP 状态码和 JSON 场景
最常被忽略的是：错误处理没显式做，比如 JSON 绑定失败时 Minimal API 默认只返回 400，不告诉你哪条字段错了；验证逻辑得自己调 Validator.TryValidateObject，没有 ModelState 自动聚合。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
