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

# Endfield API

> 终末地协议终端开放 API 平台 — 提供游戏数据查询、蓝图库社区、Wiki 百科、抽卡统计等功能API。

## 概述

**Endfield API** 是终末地协议终端的开放接口平台，为开发者和第三方客户端提供完整的终末地游戏数据服务。

<CardGroup cols={2}>
  <Card title="游戏数据查询" icon="gamepad-2">
    角色详情、武器装备、签到、搜索等终末地游戏数据接口。
  </Card>

  <Card title="Wiki 百科" icon="book-open">
    干员、武器、物品、活动等游戏百科数据，自动同步更新。
  </Card>

  <Card title="蓝图库社区" icon="layout-grid">
    蓝图发布、搜索、点赞、评论、收藏，完整的社区功能。
  </Card>

  <Card title="抽卡统计" icon="sparkles">
    个人抽卡记录同步、全服统计、卡池分析、模拟寻访。
  </Card>
</CardGroup>

## 核心能力

### 凭证体系

平台采用**接口认证**和**游戏数据凭证**分离的设计：

**接口认证（三选一，证明调用权限）**

| 认证方式                 | 请求头                     | 适用场景       |
| -------------------- | ----------------------- | ---------- |
| **Anonymous Token**  | `X-Anonymous-Token`     | 游客访问公开数据   |
| **JWT Access Token** | `Authorization: Bearer` | Web 平台登录用户 |
| **API Key**          | `X-API-Key`             | 第三方开发者/机器人 |

**游戏数据凭证（查询个人游戏数据时额外携带）**

| 凭证                  | 请求头                 | 说明                 |
| ------------------- | ------------------- | ------------------ |
| **Framework Token** | `X-Framework-Token` | 通过森空岛登录获取，对应游戏账号凭证 |

### 订阅计划

| 计划       | 价格              | 速率限制     | 日配额    | 月配额       |
| -------- | --------------- | -------- | ------ | --------- |
| **Free** | 免费              | 300 次/分钟 | 10,000 | 30,000    |
| **Pro**  | ¥9/月 \| ¥90/年   | 600 次/分钟 | 50,000 | 1,000,000 |
| **Plus** | ¥15/月 \| ¥150/年 | 无限制      | 无限制    | 无限制       |

<Tip>
  签到可免费获得额外配额，签到配额可访问 Pro 级接口。所有公开接口额外受 **IP 级别速率限制**保护（100 请求/分钟）。
</Tip>

| 量包             | 价格 | 配额       | 权限  |
| -------------- | -- | -------- | --- |
| **300000次请求包** | ¥5 | 300,000次 | Pro |

## API 基础地址

```
https://end-api.shallow.ink
```

所有 API 端点均以此为基础路径。

## 响应格式

所有接口统一返回 JSON 格式：

```json 成功响应 theme={"theme":{"light":"github-light","dark":"vitesse-dark"}}
{
  "code": 0,
  "message": "成功",
  "data": { ... }
}
```

```json 错误响应 theme={"theme":{"light":"github-light","dark":"vitesse-dark"}}
{
  "code": 400,
  "message": "请求参数错误"
}
```

## 下一步

<CardGroup cols={2}>
  <Card title="快速开始" icon="rocket" href="/quickstart">
    分清楚接口凭证和游戏数据凭证。
  </Card>

  <Card title="凭证体系" icon="shield" href="/concepts/credentials">
    了解四种认证方式的详细用法。
  </Card>
</CardGroup>