> For the complete documentation index, see [llms.txt](https://docs.elven.com/v3/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.elven.com/v3/chinese/openapi/v3/chuang-jian-source-jie-kou.md).

# 创建 source 接口

### 接口概述

该接口用于在系统中已有的账户下，创建一个新的 Source。

* **请求方式**：`POST`
* **请求 URL**：`https://openapi.elven.com/open/v3/transaction/source`

### 请求头参数

<table><thead><tr><th width="202">参数名</th><th width="90">类型</th><th width="64">必填</th><th>说明</th></tr></thead><tbody><tr><td>elven-api-key</td><td>String</td><td>是</td><td>分配给您的API密钥</td></tr><tr><td>elven-api-sign</td><td>String</td><td>是</td><td>请求签名，用于验证请求合法性</td></tr><tr><td>elven-api-timestamp</td><td>String</td><td>是</td><td>请求时间戳，毫秒级</td></tr></tbody></table>

[查看详细说明](https://docs.elven.com/v3/openapi/jie-kou-shou-quan#elven-api-sign)

### 请求参数

#### Body 参数（JSON 格式）

<table><thead><tr><th width="202">参数名</th><th width="94">类型</th><th width="66">必填</th><th>说明</th></tr></thead><tbody><tr><td>name</td><td>String</td><td>是</td><td>Source 名称<br>entity 下 source 名称不能重复</td></tr><tr><td>entityAccountId</td><td>String</td><td>是</td><td>Source 所属账户的主键 ID</td></tr><tr><td>type</td><td>String</td><td>否</td><td><p>Source 类型</p><p>OPENAPI_BALANCE 或 OPENAPI_TRANSACTION<br><br>分别对应余额数据源和交易数据源。为空时视为交易数据源</p></td></tr></tbody></table>

#### 请求示例

```json
{
    "name": "MySource",
    "entityAccountId": "abc123",
    "type": "OPENAPI_TRANSACTION"
}
```

### 响应参数

<table><thead><tr><th width="204">参数名</th><th width="98">类型</th><th>说明</th></tr></thead><tbody><tr><td>sourceId</td><td>String</td><td>Source 的主键 ID</td></tr><tr><td>name</td><td>String</td><td>Source 名称</td></tr><tr><td>type</td><td>String</td><td>Source 类型</td></tr><tr><td>entityAccountId</td><td>String</td><td>Source 所属账户的主键 ID</td></tr></tbody></table>

#### 响应示例

```json
{
    "sourceId": "def456",
    "name": "MySource",
    "type": "OPENAPI_TRANSACTION",
    "entityAccountId": "abc123"
}
```

### 在线调试

您可以通过 Apifox 服务进行接口的在线调试：<https://zswsuv3jhf.apifox.cn/api-253901217>

### 注意事项

* 请求头中的 **elven-api-key**、**elven-api-sign** 和 **elven-api-timestamp** 为必填参数，用于验证请求的合法性和安全性。
* **name** 和 **entityAccountId** 为必填参数，不能为空。
* 创建成功后，系统将返回 **sourceId**，用于后续操作。