你的三个问题解答 #

• 是否需要先配置OAuth？
  是的，这是必须步骤。ACC/BIM360的所有API都依赖OAuth 2.0身份验证。你需要先在Autodesk开发者平台创建应用，获取Client ID和Client Secret，然后在自定义连接器里配置OAuth的授权端点（https://developer.api.autodesk.com/authentication/v1/authorize）和令牌端点（https://developer.api.autodesk.com/authentication/v1/gettoken），同时勾选data:write、data:create这类与Issue读写相关的权限。

• 自定义连接器是否为通用型，需要填写公共URL？
  这里的AD应该指Autodesk吧？如果选择通用型自定义连接器，确实需要填写公共可访问的根URL，直接填Autodesk API的根地址https://developer.api.autodesk.com即可。不过更推荐创建专用连接器，直接针对Issue API的具体端点（比如创建Issue的接口是https://developer.api.autodesk.com/issues/v1/containers/{containerId}/quality-issues）配置，后续调用会更便捷。

• 验证通过后是否就能调用POST接口创建问题？
  是的，只要连接器的OAuth验证通过，且正确配置POST接口参数，就能调用。需要注意：

  • 请求头必须包含Authorization: Bearer <访问令牌>和Content-Type: application/json
  • 请求体要包含Issue的必填字段，比如标题、描述、容器ID（对应ACC/BIM360项目的ID/URN）、状态、优先级等，格式需符合Autodesk API的JSON要求

实用建议 #

• 先在Postman里手动测试API：通过OAuth流程获取访问令牌，调用创建Issue的POST接口，确认参数正确、能成功创建后再迁移到自定义连接器，可快速排查问题
• 在Autodesk开发者平台创建应用时，务必确认权限勾选完整，遗漏权限会导致调用失败
• 容器ID需要先通过ACC/BIM360的项目列表接口获取，没有正确的容器ID，Issue接口会报错

类似场景示例（GCP自定义连接器调用第三方API） #

假设要搭建GCP自定义连接器调用某第三方的资源创建接口：

1. 打开GCP连接器控制台，新建连接器，选择OAuth 2.0作为授权类型
2. 填入第三方平台的授权端点、令牌端点，以及你的应用Client ID和Client Secret，设置所需的权限范围
3. 配置POST接口：
   • 接口URL：https://api.example.com/v1/resources
   • 请求方法：POST
   • 请求头：添加Content-Type: application/json，并配置Authorization: Bearer {{access_token}}（让连接器自动注入令牌）
   • 请求体模板：

     {
       "name": "{{resource_name}}",
       "detail": "{{resource_detail}}",
       "status": "active"
     }
     

4. 进入测试环节，输入resource_name和resource_detail的测试值，发送请求验证是否能成功创建资源
5. 测试通过后，即可在GCP的工作流、AppSheet等服务中使用这个连接器调用接口

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