> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# API 连接器

> 将你已构建的集成指向 Fluz —— 无需重写。

如果你已经向 Tango、Runa 或 InComm 发送礼品卡订单，那么无需重建即可从 Fluz 购买。更改基础 URL、更换凭证，其余代码保持不变。

这正是**API 适配器**的作用。

## 什么是 API 适配器

我们将我们的 API 调用映射到了他们的接口。你的供应商所暴露的每个操作——创建订单、检查订单、读取余额——在 Fluz 里都有对应的操作，适配器位于中间，负责双向翻译。

结果就是，你先前面向 Tango、Runa 或 InComm 构建的集成现在改为从 Fluz 采购。你保留原有的请求结构，并收到你的解析器已期待的响应结构中的成功结果。

有两样是 Fluz 自有的，而不是你的供应商的：错误响应和订单状态值。二者均在[连接器行为](/connector-behaviour)中说明。

![Fluz API 适配器的工作方式](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAxMTgwIDY2MCIgd2lkdGg9IjExODAiIGhlaWdodD0iNjYwIiBmb250LWZhbWlseT0iUG9wcGlucywgSW50ZXIsIC1hcHBsZS1zeXN0ZW0sIEJsaW5rTWFjU3lzdGVtRm9udCwgJ1NlZ29lIFVJJywgc2Fucy1zZXJpZiI+CiAgPGRlZnM+CiAgICA8bGluZWFyR3JhZGllbnQgaWQ9ImJyYW5kIiB4MT0iMCIgeTE9IjAiIHgyPSIxIiB5Mj0iMCI+CiAgICAgIDxzdG9wIG9mZnNldD0iMCUiIHN0b3AtY29sb3I9IiM4NEJFRkYiLz4KICAgICAgPHN0b3Agb2Zmc2V0PSIxMDAlIiBzdG9wLWNvbG9yPSIjMjFCQTRDIi8+CiAgICA8L2xpbmVhckdyYWRpZW50PgogICAgPG1hcmtlciBpZD0iYXJyb3ciIHZpZXdCb3g9IjAgMCAxMCAxMCIgcmVmWD0iOSIgcmVmWT0iNSIgbWFya2VyV2lkdGg9IjciIG1hcmtlckhlaWdodD0iNyIgb3JpZW50PSJhdXRvLXN0YXJ0LXJldmVyc2UiPgogICAgICA8cGF0aCBkPSJNIDAgMCBMIDEwIDUgTCAwIDEwIHoiIGZpbGw9IiM5QTk2OEEiLz4KICAgIDwvbWFya2VyPgogICAgPG1hcmtlciBpZD0iYXJyb3dHcmVlbiIgdmlld0JveD0iMCAwIDEwIDEwIiByZWZYPSI5IiByZWZZPSI1IiBtYXJrZXJXaWR0aD0iNyIgbWFya2VySGVpZ2h0PSI3IiBvcmllbnQ9ImF1dG8tc3RhcnQtcmV2ZXJzZSI+CiAgICAgIDxwYXRoIGQ9Ik0gMCAwIEwgMTAgNSBMIDAgMTAgeiIgZmlsbD0iIzBFN0EzNCIvPgogICAgPC9tYXJrZXI+CiAgPC9kZWZzPgoKICA8cmVjdCB3aWR0aD0iMTE4MCIgaGVpZ2h0PSI2NjAiIGZpbGw9IiNGQkY5RjUiLz4KICA8cmVjdCB4PSIwIiB5PSIwIiB3aWR0aD0iMTE4MCIgaGVpZ2h0PSI1IiBmaWxsPSJ1cmwoI2JyYW5kKSIvPgoKICA8IS0tIFRpdGxlIC0tPgogIDx0ZXh0IHg9IjYwIiB5PSI3MiIgZm9udC1zaXplPSIyNyIgZm9udC13ZWlnaHQ9IjYwMCIgZmlsbD0iIzE0MTQwRiI+V2hhdCBhbiBBUEkgYWRhcHRlciBkb2VzPC90ZXh0PgogIDx0ZXh0IHg9IjYwIiB5PSIxMDIiIGZvbnQtc2l6ZT0iMTUiIGZpbGw9IiM2QjZCNjAiPllvdXIgaW50ZWdyYXRpb24ga2VlcHMgc3BlYWtpbmcgdGhlIHZlbmRvciYjODIxNztzIGxhbmd1YWdlLiBGbHV6IGRvZXMgdGhlIHRyYW5zbGF0aW5nLjwvdGV4dD4KCiAgPCEtLSA9PT09PT09PT09PT0gUk9XIDEgOiBUT0RBWSA9PT09PT09PT09PT0gLS0+CiAgPHJlY3QgeD0iNjAiIHk9IjE0MCIgd2lkdGg9IjEwNjAiIGhlaWdodD0iMTg4IiByeD0iMTQiIGZpbGw9IiNGRkZGRkYiIHN0cm9rZT0iI0U3RTNEOSIgc3Ryb2tlLXdpZHRoPSIxIi8+CiAgPHRleHQgeD0iODgiIHk9IjE3NCIgZm9udC1zaXplPSIxMiIgZm9udC13ZWlnaHQ9IjYwMCIgZmlsbD0iIzlBOTY4QSIgbGV0dGVyLXNwYWNpbmc9IjEuNiI+VE9EQVk8L3RleHQ+CgogIDwhLS0gYXBwIC0tPgogIDxyZWN0IHg9Ijg4IiB5PSIxOTYiIHdpZHRoPSIyNTIiIGhlaWdodD0iOTQiIHJ4PSIxMCIgZmlsbD0iI0Y0RjFFQSIgc3Ryb2tlPSIjREREOENDIiBzdHJva2Utd2lkdGg9IjEiLz4KICA8dGV4dCB4PSIyMTQiIHk9IjIzOCIgZm9udC1zaXplPSIxNiIgZm9udC13ZWlnaHQ9IjYwMCIgZmlsbD0iIzE0MTQwRiIgdGV4dC1hbmNob3I9Im1pZGRsZSI+WW91ciBhcHBsaWNhdGlvbjwvdGV4dD4KICA8dGV4dCB4PSIyMTQiIHk9IjI2MiIgZm9udC1zaXplPSIxMyIgZmlsbD0iIzZCNkI2MCIgdGV4dC1hbmNob3I9Im1pZGRsZSI+QWxyZWFkeSBidWlsdC4gQWxyZWFkeSBsaXZlLjwvdGV4dD4KCiAgPGxpbmUgeDE9IjM0OCIgeTE9IjI0MyIgeDI9IjQyNCIgeTI9IjI0MyIgc3Ryb2tlPSIjOUE5NjhBIiBzdHJva2Utd2lkdGg9IjEuNiIgbWFya2VyLWVuZD0idXJsKCNhcnJvdykiLz4KICA8dGV4dCB4PSIzODYiIHk9IjIzMCIgZm9udC1zaXplPSIxMS41IiBmaWxsPSIjOUE5NjhBIiB0ZXh0LWFuY2hvcj0ibWlkZGxlIj52ZW5kb3Itc2hhcGVkPC90ZXh0PgogIDx0ZXh0IHg9IjM4NiIgeT0iMjQ1IiBmb250LXNpemU9IjExLjUiIGZpbGw9IiM5QTk2OEEiIHRleHQtYW5jaG9yPSJtaWRkbGUiPnJlcXVlc3Q8L3RleHQ+CgogIDwhLS0gdmVuZG9yIGFwaSAtLT4KICA8cmVjdCB4PSI0MzIiIHk9IjE5NiIgd2lkdGg9IjI1MiIgaGVpZ2h0PSI5NCIgcng9IjEwIiBmaWxsPSIjRjRGMUVBIiBzdHJva2U9IiNEREQ4Q0MiIHN0cm9rZS13aWR0aD0iMSIvPgogIDx0ZXh0IHg9IjU1OCIgeT0iMjM4IiBmb250LXNpemU9IjE2IiBmb250LXdlaWdodD0iNjAwIiBmaWxsPSIjMTQxNDBGIiB0ZXh0LWFuY2hvcj0ibWlkZGxlIj5UYW5nbyAvIFJ1bmEgLyBJbkNvbW08L3RleHQ+CiAgPHRleHQgeD0iNTU4IiB5PSIyNjIiIGZvbnQtc2l6ZT0iMTMiIGZpbGw9IiM2QjZCNjAiIHRleHQtYW5jaG9yPSJtaWRkbGUiPlRoZWlyIEFQSTwvdGV4dD4KCiAgPGxpbmUgeDE9IjY5MiIgeTE9IjI0MyIgeDI9Ijc2OCIgeTI9IjI0MyIgc3Ryb2tlPSIjOUE5NjhBIiBzdHJva2Utd2lkdGg9IjEuNiIgbWFya2VyLWVuZD0idXJsKCNhcnJvdykiLz4KCiAgPCEtLSBzdXBwbHkgLS0+CiAgPHJlY3QgeD0iNzc2IiB5PSIxOTYiIHdpZHRoPSIyNTIiIGhlaWdodD0iOTQiIHJ4PSIxMCIgZmlsbD0iI0Y0RjFFQSIgc3Ryb2tlPSIjREREOENDIiBzdHJva2Utd2lkdGg9IjEiLz4KICA8dGV4dCB4PSI5MDIiIHk9IjIzOCIgZm9udC1zaXplPSIxNiIgZm9udC13ZWlnaHQ9IjYwMCIgZmlsbD0iIzE0MTQwRiIgdGV4dC1hbmNob3I9Im1pZGRsZSI+VGhlaXIgZ2lmdCBjYXJkIHN1cHBseTwvdGV4dD4KICA8dGV4dCB4PSI5MDIiIHk9IjI2MiIgZm9udC1zaXplPSIxMyIgZmlsbD0iIzZCNkI2MCIgdGV4dC1hbmNob3I9Im1pZGRsZSI+VGhlaXIgcmF0ZXM8L3RleHQ+CgogIDwhLS0gPT09PT09PT09PT09IFJPVyAyIDogV0lUSCBGTFVaID09PT09PT09PT09PSAtLT4KICA8cmVjdCB4PSI2MCIgeT0iMzYwIiB3aWR0aD0iMTA2MCIgaGVpZ2h0PSIxODgiIHJ4PSIxNCIgZmlsbD0iI0ZGRkZGRiIgc3Ryb2tlPSIjQzhFOEQyIiBzdHJva2Utd2lkdGg9IjEuNSIvPgogIDxyZWN0IHg9IjYwIiB5PSIzNjAiIHdpZHRoPSIxMDYwIiBoZWlnaHQ9IjQiIHJ4PSIyIiBmaWxsPSJ1cmwoI2JyYW5kKSIvPgogIDx0ZXh0IHg9Ijg4IiB5PSIzOTQiIGZvbnQtc2l6ZT0iMTIiIGZvbnQtd2VpZ2h0PSI2MDAiIGZpbGw9IiMwRTdBMzQiIGxldHRlci1zcGFjaW5nPSIxLjYiPldJVEggVEhFIEZMVVogQVBJIEFEQVBURVI8L3RleHQ+CgogIDwhLS0gYXBwICh1bmNoYW5nZWQpIC0tPgogIDxyZWN0IHg9Ijg4IiB5PSI0MTYiIHdpZHRoPSIyNTIiIGhlaWdodD0iOTQiIHJ4PSIxMCIgZmlsbD0iI0Y0RjFFQSIgc3Ryb2tlPSIjREREOENDIiBzdHJva2Utd2lkdGg9IjEiLz4KICA8dGV4dCB4PSIyMTQiIHk9IjQ1MiIgZm9udC1zaXplPSIxNiIgZm9udC13ZWlnaHQ9IjYwMCIgZmlsbD0iIzE0MTQwRiIgdGV4dC1hbmNob3I9Im1pZGRsZSI+WW91ciBhcHBsaWNhdGlvbjwvdGV4dD4KICA8cmVjdCB4PSIxNjQiIHk9IjQ2NiIgd2lkdGg9IjEwMCIgaGVpZ2h0PSIyNCIgcng9IjEyIiBmaWxsPSIjRTNGNEU4Ii8+CiAgPHRleHQgeD0iMjE0IiB5PSI0ODIiIGZvbnQtc2l6ZT0iMTIiIGZvbnQtd2VpZ2h0PSI2MDAiIGZpbGw9IiMwRTdBMzQiIHRleHQtYW5jaG9yPSJtaWRkbGUiPnVuY2hhbmdlZDwvdGV4dD4KCiAgPGxpbmUgeDE9IjM0OCIgeTE9IjQ2MyIgeDI9IjQyNCIgeTI9IjQ2MyIgc3Ryb2tlPSIjMEU3QTM0IiBzdHJva2Utd2lkdGg9IjEuNiIgbWFya2VyLWVuZD0idXJsKCNhcnJvd0dyZWVuKSIvPgogIDx0ZXh0IHg9IjM4NiIgeT0iNDUwIiBmb250LXNpemU9IjExLjUiIGZpbGw9IiMwRTdBMzQiIHRleHQtYW5jaG9yPSJtaWRkbGUiPnNhbWU8L3RleHQ+CiAgPHRleHQgeD0iMzg2IiB5PSI0NjUiIGZvbnQtc2l6ZT0iMTEuNSIgZmlsbD0iIzBFN0EzNCIgdGV4dC1hbmNob3I9Im1pZGRsZSI+cmVxdWVzdDwvdGV4dD4KCiAgPCEtLSBhZGFwdGVyIC0tPgogIDxyZWN0IHg9IjQzMiIgeT0iNDE2IiB3aWR0aD0iMjUyIiBoZWlnaHQ9Ijk0IiByeD0iMTAiIGZpbGw9IiMwRTdBMzQiLz4KICA8dGV4dCB4PSI1NTgiIHk9IjQ1MiIgZm9udC1zaXplPSIxNiIgZm9udC13ZWlnaHQ9IjYwMCIgZmlsbD0iI0ZGRkZGRiIgdGV4dC1hbmNob3I9Im1pZGRsZSI+Rmx1eiBBUEkgQWRhcHRlcjwvdGV4dD4KICA8dGV4dCB4PSI1NTgiIHk9IjQ3NiIgZm9udC1zaXplPSIxMyIgZmlsbD0iI0I3RThDNiIgdGV4dC1hbmNob3I9Im1pZGRsZSI+dHJhbnNsYXRlcyBpbiwgdHJhbnNsYXRlcyBiYWNrPC90ZXh0PgoKICA8bGluZSB4MT0iNjkyIiB5MT0iNDYzIiB4Mj0iNzY4IiB5Mj0iNDYzIiBzdHJva2U9IiMwRTdBMzQiIHN0cm9rZS13aWR0aD0iMS42IiBtYXJrZXItZW5kPSJ1cmwoI2Fycm93R3JlZW4pIi8+CgogIDwhLS0gZmx1eiBzdXBwbHkgLS0+CiAgPHJlY3QgeD0iNzc2IiB5PSI0MTYiIHdpZHRoPSIyNTIiIGhlaWdodD0iOTQiIHJ4PSIxMCIgZmlsbD0iI0Y0RjFFQSIgc3Ryb2tlPSIjREREOENDIiBzdHJva2Utd2lkdGg9IjEiLz4KICA8dGV4dCB4PSI5MDIiIHk9IjQ1MiIgZm9udC1zaXplPSIxNiIgZm9udC13ZWlnaHQ9IjYwMCIgZmlsbD0iIzE0MTQwRiIgdGV4dC1hbmNob3I9Im1pZGRsZSI+Rmx1eiBnaWZ0IGNhcmQgc3VwcGx5PC90ZXh0PgogIDx0ZXh0IHg9IjkwMiIgeT0iNDc2IiBmb250LXNpemU9IjEzIiBmaWxsPSIjNkI2QjYwIiB0ZXh0LWFuY2hvcj0ibWlkZGxlIj5GbHV6IHJhdGVzPC90ZXh0PgoKICA8IS0tID09PT09PT09PT09PSBGT09URVI6IHdoYXQgeW91IGNoYW5nZSA9PT09PT09PT09PT0gLS0+CiAgPHRleHQgeD0iNjAiIHk9IjU5NiIgZm9udC1zaXplPSIxMyIgZm9udC13ZWlnaHQ9IjYwMCIgZmlsbD0iIzlBOTY4QSIgbGV0dGVyLXNwYWNpbmc9IjEuMiI+QUxMIFlPVSBDSEFOR0U8L3RleHQ+CgogIDxyZWN0IHg9IjYwIiB5PSI2MDgiIHdpZHRoPSIzMzYiIGhlaWdodD0iMzYiIHJ4PSI4IiBmaWxsPSIjRkZGRkZGIiBzdHJva2U9IiNFN0UzRDkiLz4KICA8dGV4dCB4PSI3OCIgeT0iNjMxIiBmb250LXNpemU9IjEzLjUiIGZpbGw9IiMxNDE0MEYiPjx0c3BhbiBmb250LXdlaWdodD0iNjAwIj4xLjwvdHNwYW4+ICBUaGUgYmFzZSBVUkw8L3RleHQ+CgogIDxyZWN0IHg9IjQyMiIgeT0iNjA4IiB3aWR0aD0iMzM2IiBoZWlnaHQ9IjM2IiByeD0iOCIgZmlsbD0iI0ZGRkZGRiIgc3Ryb2tlPSIjRTdFM0Q5Ii8+CiAgPHRleHQgeD0iNDQwIiB5PSI2MzEiIGZvbnQtc2l6ZT0iMTMuNSIgZmlsbD0iIzE0MTQwRiI+PHRzcGFuIGZvbnQtd2VpZ2h0PSI2MDAiPjIuPC90c3Bhbj4gIFRoZSBBdXRob3JpemF0aW9uIGhlYWRlcjwvdGV4dD4KCiAgPHJlY3QgeD0iNzg0IiB5PSI2MDgiIHdpZHRoPSIzMzYiIGhlaWdodD0iMzYiIHJ4PSI4IiBmaWxsPSIjRkZGRkZGIiBzdHJva2U9IiNFN0UzRDkiLz4KICA8dGV4dCB4PSI4MDIiIHk9IjYzMSIgZm9udC1zaXplPSIxMy41IiBmaWxsPSIjMTQxNDBGIj48dHNwYW4gZm9udC13ZWlnaHQ9IjYwMCI+My48L3RzcGFuPiAgWW91ciBicmFuZCBpZGVudGlmaWVyczwvdGV4dD4KPC9zdmc+Cg==)

把它想象成旅行用的插头转换器。电器不变，墙上的插座不变，中间有个装置让两者匹配。

## 映射的工作方式

你的请求以供应商的形状到达。适配器将路由和字段翻译成等价的 Fluz 操作，在 Fluz 供给上执行，然后将结果翻译回你的代码已期待的响应结构。

<img src="https://mintcdn.com/fluz-dd3e0eaa/ntRBNWQmiqBrvQt4/images/fluz-api-adapter-technical.svg?fit=max&auto=format&n=ntRBNWQmiqBrvQt4&q=85&s=75f36d0c5db48f78ea6ee25b2df40848" alt="通过 Fluz API 适配器的请求与响应映射" width="1180" height="800" data-path="images/fluz-api-adapter-technical.svg" />

### 操作映射

每个连接器页面都会发布其供应商的完整映射表。以 Tango Card 为例：

| Operation                 | Your existing call                 | Fluz endpoint                      |
| :------------------------ | :--------------------------------- | :--------------------------------- |
| Create order              | `POST /v2/orders/`                 | `POST /v2/orders/`                 |
| Get order                 | `GET /v2/orders/:referenceOrderID` | `GET /v2/orders/:referenceOrderID` |
| Get all orders            | `GET /v2/orders`                   | `GET /v2/orders`                   |
| Get balance, all accounts | `GET /v2/accounts`                 | `GET /v2/accounts`                 |
| Get balance, one account  | `GET /v2/accounts/:accountId`      | `GET /v2/accounts/:id`             |

路径和动词是刻意保持不变的。适配器的意义在于，你的路由层无需感知任何改变。

### 字段映射

再次以 Tango Card 为例：

| Field in your request | What Fluz does with it                         |
| :-------------------- | :--------------------------------------------- |
| `utid` / brand code   | **在 Fluz 商品目录中进行解析。参见下方警告**                    |
| `amount`              | 购买金额                                           |
| `externalRefID`       | 接受。使用响应中的 `referenceOrderID` 来关联订单             |
| `accountIdentifier`   | 订单从签发你 API key 的账户出资。若你在多个账户间拆分资金，请为每个账户申请一个密钥 |
| `customerIdentifier`  | 为保持与现有请求结构的兼容性而保留                              |

<Callout icon="📘">
  **Tango 和 InComm 会同步返回完整结果。** 调用在购买完成前不会返回，可能需要长达 150 秒，因此请将客户端的读取超时设置得高于此。Runa 默认是异步：它会立即返回一个引用 ID，你需在完成后再读取订单。发送 `X-Execution-Mode: sync` 可改为等待完整结果。二者均在[连接器行为](/connector-behaviour)中说明。
</Callout>

### 各供应商的请求约束

你的供应商请求结构会按原样接受，但少数取值被固定。必须关闭对收件人的邮件投递，订单为单收件人且单产品，且 Runa 订单必须使用美元账户余额出资。违反上述任一规则的请求会被拒绝。

完整列表见[连接器行为](/connector-behaviour)。在切换前，请结合你的连接器页面上的请求示例一起阅读。

## 哪些会改变，哪些不会

|                                                      | Before | After                |
| :--------------------------------------------------- | :----- | :------------------- |
| Request shapes                                       | 供应商的模式 | **不变**               |
| Successful response shapes                           | 供应商的模式 | **不变**               |
| Base URL                                             | 供应商主机  | Fluz 适配器主机           |
| Credential                                           | 供应商密钥  | 你的 Fluz API key      |
| Order status values                                  | 供应商的   | **Fluz 的。请更新你的状态检查** |
| Error responses                                      | 供应商的模式 | **Fluz 的封套**         |
| Brand identifiers (`utid`, brand slug, product code) | 供应商目录  | **Fluz 目录——必须重新映射**  |
| Rates and discounts                                  | 供应商的   | Fluz 的               |
| Supplier of record, invoicing, reconciliation        | 供应商    | Fluz                 |

<Callout icon="⚠️">
  **品牌标识符是你必须更改的唯一项。** 适配器不会将供应商的产品目录翻译为 Fluz 的。Tango 的 `utid` 为 `U561593` 并不等同于 Fluz 的 `utid` 为 `1800FL-US`。在切换前，请将你的品牌清单与 Fluz 目录进行映射，否则你的订单会成功但发放到错误的卡。
</Callout>

## 三步完成切换

<Steps>
  <Step title="更改基础 URL">
    将你现有的客户端指向该供应商的 Fluz 适配器主机。对于 Tango Card，测试环境为 `https://api-adapter.staging.fluzapp.com/tangocard`，生产环境为 `https://api-adapter.fluzapp.com/tangocard`，替代 `https://integration-api.tangocard.com/rass`。每个连接器页面都会列出两个主机。
  </Step>

  <Step title="更改 Authorization 头">
    每个连接器都使用携带你的 Fluz API key 的 HTTP Basic 认证：`Authorization: Basic <FLUZ-API-Key>`。移除供应商的用户名与密码。
  </Step>

  <Step title="重新映射你的品牌标识符并发送相同调用">
    将供应商产品代码替换为其 Fluz 等价物。其他一切——路径、动词、请求体、响应解析——保持不变。
  </Step>
</Steps>

## 可用的连接器

<CardGroup cols={3}>
  <Card title="礼品卡" icon="🎁" href="#pick-your-vendor">
    **已文档化并可用。** Tango Card、Runa、InComm——每个都有已发布的端点对照与请求示例。
  </Card>

  <Card title="支付处理" icon="💳">
    **Beta。** Stripe、Worldpay、TSYS、Checkout、Braintree、TabaPay、Finix、Authorize.net、Sola / Cardknox。请联系销售以获取提前访问与端点详情。
  </Card>

  <Card title="钱包提现" icon="💸">
    **Beta。** Venmo 和 PayPal。请联系销售以获取提前访问与端点详情。
  </Card>
</CardGroup>

礼品卡连接器已较为成熟，也是目前唯一具备发布到操作级别文档的系列。每个礼品卡连接器页面都会列出已实现的具体操作，以及其对应的原始供应商端点。

## 覆盖范围以操作为单位

<Callout icon="📘">
  **适配器仅实现每个连接器页面上列出的那些操作。** 每个操作都是为该操作量身定制的翻译，而非一刀切的透传。
</Callout>

如果某个操作未出现在连接器页面的端点对照表中，说明它尚未构建。

在开始之前，列出你今天的集成所调用的每一个供应商端点，并逐一与连接器页面核对。如果缺少了你依赖的内容，请在启动前告知你的 Fluz 联系人——大多数缺口都是一些小补充，但仍需要进行范围评估。

## 连接器与 Fluz GraphQL API 相互独立

这点常让人混淆，因此值得直说。Fluz 提供两种截然不同的开发者接口，并且它们不共享凭证。

|                   | API Connectors        | Fluz API                    |
| :---------------- | :-------------------- | :-------------------------- |
| Protocol          | REST，形如供应商            | GraphQL                     |
| Authentication    | Basic，使用 Fluz API key | Bearer，使用 User Access Token |
| Credential source | 向 Fluz 申请签发           | 在控制台的 Developers 分区自助生成     |
| Scope             | 你旧供应商所支持的那些操作         | 完整的 Fluz 平台                 |

<Callout icon="🔑">
  **连接器密钥不是控制台密钥。** 你在 Fluz 控制台的 Developers 分区生成的 API key 无法用于连接器认证，反之亦然。连接器凭证由 Fluz 配置。请联系你的 Fluz 代表以申请。
</Callout>

## 何时使用连接器，何时不该

<CardGroup cols={2}>
  <Card title="适合使用连接器的场景" icon="⚡">
    你已有上线运行的供应商集成，想要快速获得 Fluz 供给与 Fluz 费率，并且不希望为切换投入一个工程周期。上线周期以天计。
  </Card>

  <Card title="适合使用 Fluz API 的场景" icon="🧩">
    你想要完整的平台能力：虚拟卡、钱包与消费账户、交易数据、webhooks、返现费率、报价，以及完整的商户目录。这些都无法通过供应商形接口访问。
  </Card>
</CardGroup>

常见路径是先用连接器让交易量流入，然后在逐步采用旧供应商不具备的能力时迁移到[Fluz API](/overview)。

## 获取访问权限

API 连接器目前以 beta 计划提供。请联系你的 Fluz 代表或发送邮件至销售团队以申请连接器凭证，并确认你所用供应商的操作覆盖范围。

## 选择你的供应商

<CardGroup cols={3}>
  <Card title="Tango Card" icon="🔌" href="/tango">
    订单与账户余额。Basic 认证，同步响应。
  </Card>

  <Card title="Runa" icon="🔌" href="/runa">
    订单与货币余额。同步与异步执行模式。
  </Card>

  <Card title="InComm" icon="🔌" href="/in-comm">
    即时下单、订单详情、卡片获取与项目余额。
  </Card>
</CardGroup>
