# Blockchain Atlantis

<button type="button" class="button primary" data-action="ask" data-icon="gitbook-assistant">問我任何問題…</button>

<button type="button" class="button secondary" data-action="ask" data-query="我要如何開始使用 Blockchain Atlantis？" data-icon="rocket-launch">開始使用</button><button type="button" class="button secondary" data-action="ask" data-query="我要如何用 API key 認證？" data-icon="key">認證</button><button type="button" class="button secondary" data-action="ask" data-query="Credit 計費怎麼算？" data-icon="coins">計費</button>

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><h4><i class="fa-book">:book:</i></h4></td><td><strong>開發者文件</strong></td><td>從第一次呼叫到進階整合。</td><td><a href="https://api.atlantis.example/docs">https://api.atlantis.example/docs</a></td><td><a href="/files/Al3EzzAnd0lsh8AVNAH6">/files/Al3EzzAnd0lsh8AVNAH6</a></td></tr><tr><td><h4><i class="fa-terminal">:terminal:</i></h4></td><td><strong>API 參考</strong></td><td>瀏覽、試打與串接所有端點。</td><td><a href="https://api.atlantis.example/docs">https://api.atlantis.example/docs</a></td><td><a href="/files/UsRfHwX3KMzdt8WiME21">/files/UsRfHwX3KMzdt8WiME21</a></td></tr><tr><td><h4><i class="fa-circle-question">:circle-question:</i></h4></td><td><strong>說明中心</strong></td><td>計費、管理與疑難排解。</td><td><a href="https://api.atlantis.example/docs">https://api.atlantis.example/docs</a></td><td><a href="/files/DZSEnq4KEz2xiSKJoWBw">/files/DZSEnq4KEz2xiSKJoWBw</a></td></tr></tbody></table>

{% columns %}
{% column width="50%" %}

## 五分鐘內開始

只要一把 API key，就能發出第一個請求。

Blockchain Atlantis 是面向企業與政府的區塊鏈服務統一 API gateway。透過單一入口，你就能存取各項區塊鏈資料與情報服務，並自動獲得認證、限流、用量計費與審計等企業級保障。

{% hint style="info" icon="sparkle" %}
**統一信封**

所有成功回應都包在 `{ data, meta }` 內，所有錯誤都包在 `{ error }` 內——一套解析邏輯走遍所有端點。
{% endhint %}

{% hint style="success" icon="key" %}
**用量計費，成功才扣**

以 credit 計價，只有成功（2xx）的回應才扣點，每次回應都附上本次成本與剩餘餘額。
{% endhint %}
{% endcolumn %}

{% column width="50%" %}
{% stepper %}
{% step %}

#### 取得 API key

請你方管理員在管理後台建立一把 key，並保存一次性回傳的明碼。
{% endstep %}

{% step %}

#### 發出第一個請求

把 key 放進 `X-API-Key`，即可呼叫。

{% tabs %}
{% tab title="cURL" %}

```bash
curl https://api.atlantis.example/v1/webhooks \
  -H "X-API-Key: ak_live_YOUR_KEY"
```

{% endtab %}

{% tab title="Python" %}

```python
import requests

resp = requests.get(
    "https://api.atlantis.example/v1/webhooks",
    headers={"X-API-Key": "ak_live_YOUR_KEY"},
)
print(resp.json())
```

{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

#### 看懂回應

```json
{
  "data": [],
  "meta": { "request_id": "9b1c2d3e-..." }
}
```

{% endstep %}
{% endstepper %}
{% endcolumn %}
{% endcolumns %}


---

# 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/readme.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.