自定义连接器

自定义连接器是你自己描述的服务：互联网上任何使用密钥的 API。创建之后，你的应用会像使用列表中的任何连接器一样使用它，通过 Setherion 调用，密钥保存在我们的服务器上。

点击 Connectors 页面右上角的 +，再点击 Custom connector，然后填写：

• Details：一个 Display name，一段用于列表的 Short description，一段更长的 Description，一个 Category，以及可选的文档地址。
• Authentication：密钥如何传送，可以是 Bearer token、API key in a header（你来指定标头名称）、API key in the address（你来指定参数名称），或 Username and password。你还可以指定向人们索取的内容，比如“Password”。What requests to this API will look like 会随你的选择显示请求的样子。然后是 API base URL，即每个请求的起点，以及 Test request：一个没有有效密钥就会失败的简单调用，比如返回当前账户的调用。
• Who may use it：Only your app's team（默认）、Visitors can read 或 Anybody，然后选择应用可以发送的请求类型：GET 用于读取，其他类型会修改数据。选择 Visitors can read 时，任何打开应用的人都可以读取，只有团队可以修改。选择 Anybody 时，每个人都可以发起你允许的所有调用，同时对每位访客的调用限制会更严格，所以只在专为此设计的 API 上选择它。
• Agent knowledge：可选，但值得写：各个路径，每个路径的一次请求和一次回答，以及任何容易出错的地方。Setherion 在构建你的应用时会读取它。没有它，Setherion 只能猜测路径，而猜测可能出错：比如说明哪个路径返回你自己的账户。千万不要在这里粘贴密钥。

表单里不填密钥。Create 会打开连接器的页面，你在那里添加密钥，点击 Test connection，然后连接，和其他服务一样。Edit 和 Delete 也在这个页面上。删除它时，它的密钥也会一并删除，使用它的应用会立即无法再访问它。

提问：连接好并为某个应用勾选之后，按名称提出要求：“在仪表盘上显示我在 Acme 的未完成项目。”“添加一个按钮，在 Acme 中创建任务。”

• API base URL 必须以 https:// 开头，并且位于公共互联网上。私有网络内的地址、IP 地址，或使用 443 以外端口的地址，在保存时会被拒绝，每次调用时也会再次被拒绝。
• 自定义连接器属于你自己：它们不会借给团队工作区的成员，而列出了其应用可使用的连接器的工作区也不会包含它们。
• 最多可以有 25 个。
• 如果只是某个应用需要一个密钥，密钥与机密可能就够了。