Skip to content

自定义 API 操作(Custom API operations)#

One of the most complex parts of setting up API calls is managing authentication. n8n provides credentials support for operations and services beyond those supported by built-in nodes.

  • Custom operations for existing nodes: n8n supplies hundreds of nodes to create workflows that link multiple products. However, some nodes don't include all the possible operations supported by a product's API. You can work around this by making a custom API call using the HTTP Request node.
  • Credential-only nodes: n8n includes credential-only nodes. These are integrations where n8n supports setting up credentials for use in the HTTP Request node, but doesn't provide a standalone node. You can find a credential-only node in the nodes panel, as you would for any other integration.

预定义凭据类型(Predefined credential types)#

预定义凭证类型是指在 n8n 中已存在的凭证。你可以在 HTTP 请求节点中使用预定义凭证类型，而不是通用凭证。

🌐 A predefined credential type is a credential that already exists in n8n. You can use predefined credential types instead of generic credentials in the HTTP Request node.

例如：你创建了一个 Asana 凭证，用于 Asana 节点。后来，你想执行一个 Asana 节点不支持的操作，可以使用 Asana 的 API。你可以在 HTTP 请求节点中使用现有的 Asana 凭证来执行该操作，而无需额外的身份验证设置。

🌐 For example: you create an Asana credential, for use with the Asana node. Later, you want to perform an operation that isn't supported by the Asana node, using Asana's API. You can use your existing Asana credential in the HTTP Request node to perform the operation, without additional authentication setup.

使用预定义凭据类型(Using predefined credential types)#

To use a predefined credential type:

  1. Open your HTTP Request node, or add a new one to your workflow.
  2. In Authentication, select Predefined Credential Type.
  3. In Credential Type, select the API you want to use.
  4. In Credential for <API name>, you can:
    1. Select an existing credential for that platform, if available.
    2. Select Create New to create a new credential.

凭据范围(Credential scopes)#

某些现有的凭证类型有特定的作用范围：它们可以使用的端点。n8n 在你选择凭证类型时会对此发出警告。

🌐 Some existing credential types have specific scopes: endpoints that they work with. n8n warns you about this when you select the credential type.

例如，按照 使用预定义凭证类型 中的步骤操作，然后选择 Google Calendar OAuth2 API 作为你的 凭证类型。n8n 会显示一个框，列出你可以使用此凭证类型的两个端点：

🌐 For example, follow the steps in Using predefined credential types, and select Google Calendar OAuth2 API as your Credential Type. n8n displays a box listing the two endpoints you can use this credential type with:

The scopes box