# 服務概觀

Blockchain Atlantis 是一個 **API gateway**：你的應用程式只要對接這一個入口，就能存取背後的各項區塊鏈資料與情報服務。Gateway 負責處理認證、限流、計費、審計與可觀測性，讓你專注在業務本身。

## 運作方式

```
你的應用程式
   │  HTTPS + X-API-Key
   ▼
Blockchain Atlantis Gateway   ← 認證・限流・計費・審計
   │
   ▼
各項區塊鏈服務（交易、地址、情報…）
```

每一次請求都會：

1. 以 `X-API-Key` 驗證身分。
2. 依「API key + 端點」做限流。
3. 呼叫對應的後端服務。
4. **成功（2xx）時**才依端點權重扣除 credit。
5. 寫入審計紀錄，並在回應帶上 `X-Request-Id`、`X-Credit-Cost`、`X-Credit-Remaining`。

## 你需要知道的基本約定

| 項目   | 約定                                            |
| ---- | --------------------------------------------- |
| 通訊協定 | HTTPS，REST + JSON                             |
| 認證   | 在 HTTP header 帶 `X-API-Key: <你的 key>`         |
| 成功回應 | 一律包在 `{ "data": ..., "meta": ... }` 信封內       |
| 錯誤回應 | 一律包在 `{ "error": { "code", "message" } }` 信封內 |
| 版本   | 路徑前綴 `/v1`                                    |
| 分頁   | 查詢參數 `?limit=&offset=`                        |
| 計費   | credit 制，成功才扣，回應 header 附本次成本與餘額              |

## 兩個平面

Blockchain Atlantis 把「使用服務」與「管理帳號」分成兩個獨立平面：

{% tabs %}
{% tab title="資料平面（給應用程式）" %}
你的應用程式呼叫的業務 API，例如 `/v1/webhooks`、`/v1/stream`。

* 用 **API key** 認證（`X-API-Key`）。
* 套用限流與 credit 計費。
  {% endtab %}

{% tab title="控制平面（給管理員）" %}
你方管理員使用的後台，用來建立／撤銷 API key、調整 credit、管理方案。

* 用 **帳號密碼登入** 取得 session（非 API key）。
* 不計費、不限流。詳見[管理後台](/documentation/cao-zuo-zhi-nan/admin-console.md)。
  {% endtab %}
  {% endtabs %}

## 下一步

{% content-ref url="/pages/fMIKfNrelo451cfsRJe8" %}
[快速上手](/documentation/kai-shi-shi-yong/quickstart.md)
{% endcontent-ref %}

{% content-ref url="/pages/MFQ1oeKPnts4wocXInGo" %}
[認證與 API key](/documentation/kai-shi-shi-yong/authentication.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.blockchainsecurity.asia/documentation/kai-shi-shi-yong/overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.