如何使用FastAPI发送带loginOrEmail和role的POST请求添加Grafana组织用户

你的原有代码存在两个核心错误：

1. 你写的app.post()是FastAPI用来定义自身提供的API接口的装饰器，不是用来向外发送POST请求的方法
2. Pydantic模型的字段定义语法错误，应该指定字段类型，而非直接写默认值

正确实现步骤 #

第一步：安装依赖 #

需要安装httpx作为HTTP客户端用来向Grafana接口发请求，同时保留FastAPI和pydantic依赖：

pip install fastapi uvicorn httpx pydantic

第二步：修正代码逻辑 #

实现逻辑为：先定义接收参数的Pydantic模型，再在接口逻辑里用httpx向Grafana的组织加用户接口发请求：

from fastapi import FastAPI
from pydantic import BaseModel
import httpx

# 正确定义Pydantic请求模型，指定字段类型
class AddGrafanaUserRequest(BaseModel):
    loginOrEmail: str
    role: str # 可选值一般为Viewer/Editor/Admin，按Grafana要求传即可

app = FastAPI()

# 这里定义你自己的接口路径，比如/add-grafana-user
@app.post("/add-grafana-user")
async def add_user_to_grafana(user_req: AddGrafanaUserRequest):
    # 替换成你实际的Grafana加用户接口地址
    GRAFANA_API_URL = "你的Grafana组织加用户接口的完整链接"
    # 替换为你实际的Grafana API令牌，需要有组织用户管理权限
    GRAFANA_API_TOKEN = "你的Grafana API令牌"
    
    headers = {
        "Authorization": f"Bearer {GRAFANA_API_TOKEN}",
        "Content-Type": "application/json"
    }
    
    # 构造发往Grafana的请求参数
    grafana_req_body = {
        "loginOrEmail": user_req.loginOrEmail,
        "role": user_req.role
    }
    
    # 异步发送POST请求到Grafana
    async with httpx.AsyncClient() as client:
        response = await client.post(
            url=GRAFANA_API_URL,
            json=grafana_req_body,
            headers=headers
        )
        response.raise_for_status()
        # 返回Grafana的响应结果
        return response.json()

第三步：调用你自己的接口 #

启动服务后，你可以通过两种方式发请求测试：

• 直接访问FastAPI自带的Swagger文档：http://你的服务地址/docs，在可视化界面填参数发送请求
• 用curl命令请求：

curl -X POST "http://你的服务地址/add-grafana-user" \
-H "Content-Type: application/json" \
-d '{"loginOrEmail": "目标用户邮箱/登录名", "role": "Viewer"}'

注意事项 #

• 需要先在Grafana后台创建有权限添加组织用户的API令牌，确保令牌的权限范围包含组织用户管理
• Grafana官方加组织用户的接口路径一般为/api/orgs/{org_id}/users，需要替换成你实际的组织ID和服务地址
• 如果不需要封装成FastAPI接口，只是单纯要发请求加用户，直接用httpx或者requests写脚本即可，不用启动FastAPI服务

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