导入企业系统接口

支持内联 OpenAPI、HTTPS OpenAPI 地址、Tool Manifest 或远程 MCP 服务；同一幂等键只能对应同一请求内容。远程服务只保存版本化连接快照，不保存明文凭据。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

示例

{
    "externalId": "crm-main",
    "name": "CRM 主系统",
    "credentialId": "cred_example",
    "metadata": {
        "owner": "sales"
    },
    "source": {
        "type": "openapiUrl",
        "url": "https://specs.example.com/crm.yaml"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢201

application/json

已原子创建的集成、候选版本和标准化工具。

Bodyapplication/json

示例

{
    "id": "int_example",
    "externalId": "crm-main",
    "name": "CRM 主系统",
    "status": "active",
    "metadata": {
        "owner": "sales"
    },
    "version": {
        "id": "intv_example",
        "revision": 1,
        "status": "draft",
        "sourceKind": "openapiUrl",
        "sourceHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "importReport": {
            "imported": 1,
            "skipped": 0
        },
        "credentialId": "cred_example",
        "testedAt": null,
        "publishedAt": null,
        "failureCode": null,
        "testReport": {},
        "createdAt": "2026-09-27T08:00:00.000Z",
        "updatedAt": "2026-09-27T08:00:00.000Z"
    },
    "createdAt": "2026-09-27T08:00:00.000Z",
    "updatedAt": "2026-09-27T08:00:00.000Z",
    "disabledAt": null,
    "tools": [
        {
            "id": "tool_example",
            "externalId": "getCustomer",
            "name": "getCustomer",
            "status": "active",
            "version": {
                "id": "toolv_example",
                "revision": 1,
                "status": "draft",
                "manifest": {
                    "version": 1,
                    "sourceOperationId": "getCustomer",
                    "namespace": "crm",
                    "name": "getCustomer",
                    "description": "查询客户",
                    "inputSchema": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "id"
                        ],
                        "additionalProperties": false
                    },
                    "outputSchema": {
                        "type": "object"
                    },
                    "http": {
                        "method": "GET",
                        "origin": "https://crm.example.com",
                        "pathTemplate": "/customers/{id}",
                        "parameters": [
                            {
                                "argument": "id",
                                "location": "path",
                                "target": "id",
                                "required": true
                            }
                        ]
                    },
                    "risk": {
                        "level": "low",
                        "actionClass": "read",
                        "facts": {
                            "httpMethod": "GET",
                            "matchedTerms": [],
                            "externallyCommitting": false,
                            "destructive": false,
                            "financial": false,
                            "requiresExplicitAuthorization": false
                        }
                    },
                    "timeoutMs": 10000,
                    "retryClass": "safeRead"
                },
                "riskLevel": "low",
                "actionClass": "read",
                "publishedAt": null,
                "createdAt": "2026-09-27T08:00:00.000Z",
                "updatedAt": "2026-09-27T08:00:00.000Z"
            }
        }
    ]
}

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠409Conflict

🟠413PayloadTooLarge

🔴500InternalError