网关调用（Basic）

通过部署已启用的 Basic 网关调用授权接口，由网关处理目标调用所需的令牌与签名。

项目	内容
方法	POST
路径	/open-api/openapi/whitelist/gateway/invoke
认证	Basic 客户端认证 + 授权 username + 租户与应用上下文
请求格式	application/json

调用准备

参见公共请求约定。保存下面的 JSON 为 UTF-8 的 request.json，再替换地址、令牌和字段占位值。cURL 多行示例在 PowerShell 中可改为单行 curl.exe。

请求参数

参数	类型 / 必填	说明
username	字符串 / 是	已获当前租户和应用授权的用户。
api	字符串 / 是	目标 OpenAPI 相对路径，示例为 V2 新增。
table	字符串 / 按目标接口	目标表单 ID。
data	对象 / 按目标接口	目标接口要求的业务数据。
id / ids	字符串 / 数组 / 按目标接口	更新或删除时按目标协议提供。

请求示例

request.json

{
  "username": "YOUR_AUTHORIZED_USERNAME",
  "api": "/open-api/openapi/form/v2/insert",
  "table": "YOUR_FORM_ID",
  "data": {
    "YOUR_TEXT_FIELD": "事项甲"
  }
}

curl --request POST "https://admin.duoge.work/api/open-api/openapi/whitelist/gateway/invoke" \
  --header "Authorization: Basic BASE64_OF_CLIENT_ID_COLON_CLIENT_SECRET" \
  --header "TENANT-ID: YOUR_NUMERIC_TENANT_ID" \
  --header "X-APPLICATION-ID: YOUR_APPLICATION_ID" \
  --header "Content-Type: application/json" \
  --data-binary "@request.json"

返回说明

网关返回目标接口执行结果；先检查 HTTP 和业务状态，再按目标接口解释 data。新增、修改和删除响应不是同一种记录对象。调用超时不代表目标没有写入，需要查询确认。

使用说明与排错

Basic 值为管理员交付的 client_id:client_secret 的 Base64 编码，不使用 Access Secret 或用户密码。Base64 不是加密，仅通过 HTTPS 在服务端调用。username 必须获得授权，不能因为网关帮助获取令牌就当作匿名接口。api 使用管理员确认可调用的路径，不将网关当作任意 URL 代理。

也支持根级 data.字段名 形式；优先使用本例嵌套 data，避免两种结构同时提供冲突值。直接接口则见新增、更新及删除。