Final Fantasy XIV

简介

XIVAPI 是《最终幻想 14》的社区维护数据库 API：道具、角色、职业、任务、成就、市场数据等——免密钥且支持 CORS。是 FFXIV 粉丝工具、市场追踪器和角色展示应用的标准后端。

快速开始

一个道具（实测可用——Item 1234）：

curl "https://xivapi.com/Item/1234"

{
  "ID": 1234,
  "Name": "Crystal",
  "Icon": "/i/020000/020001.png",
  "Description": "A crystalline formation..."
}

搜索道具：

curl "https://xivapi.com/search?string=excalibur&indexes=Item"

角色搜索：

curl "https://xivapi.com/character/search?name=Ardbert&server=Omega"

市场板数据（大多数市场端点需要公开 API 密钥）：

curl "https://xivapi.com/market/1/1234" -H "X-API-Key: YOUR_KEY"

认证方式

• 公开端点（道具、搜索、角色）免密钥（实测可用）。
• 市场数据和较重端点需要免费公开 API 密钥（xivapi.com → 登录 → 获取密钥），通过 X-API-Key 请求头携带。

速率限制与注意事项

• 免密钥请求有限流（匿名约 10 次/分钟）；带密钥约 60 次/分钟——请缓存响应。
• 数据从游戏客户端文件抓取/策展——字段遵循游戏内部结构（大写键如 ID、Name）。
• 图标/图片从 xivapi.com/i/... 路径提供——支持热链。
• 项目社区运营；可用性总体良好但不保证。

常见问题

XIVAPI 免费吗？ 是的——公开数据免密钥；免费密钥提高配额并解锁市场数据。

需要密钥吗？ 市场端点和更高配额需要——注册免费。

为什么键名是大写？ 数据镜像了游戏客户端的内部 schema。