ESI接口说明

来自EVE百科
跳转到导航 跳转到搜索
翻译状态: 本文(或部分内容)是 EVE Swagger Interface 的翻译。源文本更新日期为 2022-4-7。若英文版本有所更改,则您可以帮助同步翻译更改的内容。

ESI接口(EVE Swagger Interface)是一组API,第三方应用程序可以使用它与来自 EVE 游戏服务器的数据进行交互,点此查看ESI UI页面。它取代了 2018 年 5 月 8 日关闭的 CREST 和 XML API。[1]

ESI有公开的数据接口,也有需要用户身份验证的接口,后者需要用户通过EVE SSO登录他们的游戏帐户,以便访问游戏角色的相关信息,或者,如果他们的角色在军团中任职的话,也可以查看军团的相关信息。 目前有 81 个公开接口和 125 个需要身份验证的接口(总共 206 个)。

CCP 表示,他们的目标是用 ESI 完全取代SDE静态文件,但截至 2020 年 6 月,仍有许多功能缺失。 例如,工业蓝图仍然需要SDE。

注意,CCP明确禁止第三方应用程序的开发者使用ESI开发恶意程序[2][3]

ESI 和 SSO 通常一起使用,但它们也有独立的功能和用途。 因此,它们被拆分成各自的文章。 有关角色验证(及其管理)方面的信息,请参阅 EVE SSO

ESI接口类别

ESI 提供了 206 个端点,其中 81 个为公开数据且不需要角色或客户端身份验证,其中 135 个需要身份验证,因为它们与特定角色或公司的信息相关。

这些接口的类别如下:

种类 公开 需验证 描述
Alliances 4 有关联盟及其成员公司的一般信息
Assets 6 角色和公司的资产详情
Bookmarks 4 所有角色或公司的书签和书签文件夹(译注: 应该是和地点有关的,相关接口是绿色的开通状态,但也有可能在维护中[4]
Calendar 4 读取、响应角色的日历事件
Character 4 11 与角色相关的信息,不属于其他类别。
Clones 2 有关角色克隆及其植入物的信息
Contacts 9 读取角色、公司和联盟的联系人列表,编辑角色的联系人列表。
Contracts 3 6 列出公开合同、私人合同和公司合同、它们的出价及其中包含的项目。
Corporation 4 18 与公司相关的信息,不属于其他类别。
Dogma 5 关于Dogma的信息,EVE的物品和实体属性系统。
Faction Warfare 6 2 有关势力战争,星系、排行榜等公共统计数据和角色统计数据。
Fittings 3 查看、创建或删除角色在游戏中保存的舰船装配。
Fleets 14 为舰队提供的非常全面的接口,允许在游戏外对其进行管理。
Incursions 1 当前活跃的入侵列表和它们的一些基本信息
Industry 2 6 星系的成本指数、工业设施以及有关角色活跃行业工作的所有信息。
Insurance 1 所有船舶类别的保险价格清单。
Killmails 1 2 检索与角色相关的km,或其他您有权限查看的km。
Location 3 查看一个角色是否在线,他们在使用什么船,以及他们所在的位置。
Loyalty 1 1 查看NPC军团的忠诚点物品清单,及角色可用的LP。
Mail 9 与角色查看、发送和删除游戏内邮件相关的所有操作。
Market 6 5 市场订单和历史数据,以及角色或公司的订单。
Opportunities 4 1 与新玩家经历/教程相关的任务列表,以及角色是否完成了这些任务。
Planetary Industry 1 3 有关角色行星殖民地及其布局的详细信息,以及公开的行星工业合成信息。
Routes 1 使用游戏内算法计算两个星系之间的路线
Search 1 1 针对所选类别搜索指定的字符串。如果使用角色接口,还将搜索该角色可以看到的私人物品。
Skills 3 有关角色属性、技能和技能训练队列的信息。
Sovereignty 3 主权战列表,包括星系和结构。
Status 1 游戏状态:是否正在运行,是什么版本,有多少玩家登录。
Universe 30 几乎所有游戏内公开的静态数据。
User Interface 5 如果角色已登录游戏,则允许为角色打开某些 UI 窗口。
Wallet 6 角色和公司钱包余额和交易。
Wars 3 游戏中发生的所有战争的详细信息,包括km。

开发者资源

对于希望开始使用 ESI 的开发人员,这里有许多在线资源,其中许多资源还涵盖了用于验证接口的SSO。

https://docs.esi.evetech.net/ 社区维护的ESI文档。
https://esi.evetech.net/ui/ CCP提供的的前端用户界面,用来“玩”ESI并探索各种接口可以做什么。
https://github.com/esi/esi-issues 用于跟踪ESI问题和请求的官方Git存储库。
https://github.com/esi/esi-issues/issues/1103 上述存储库中的一个特定issue,用于比较ESI和SDE的可用信息。
https://community.eveonline.com/news/dev-blogs/introducing-esi/ 介绍ESI的原始公告。
https://github.com/devfleet/awesome-eve#developer-tools-resources-and-apis 社区维护的与ESI一起使用的资源和工具列表。
https://forums.eveonline.com/t/3-3-0-gesi-google-sheets-esi-library/13406 GESI - 在 Google 表格中使用 ESI 的库
https://developers.eveonline.com/blog/article/using-esi-with-google-sheets 有点过时的CCP开发博客,介绍GESI的使用。(参见上一条)
https://www.fuzzwork.co.uk/2017/03/14/using-esi-google-sheets/ 使用GESI的一些指南(参见上上条)
https://web.archive.org/web/20190310221844/https://wiki.zansha.space/index.php/SSO_Authentication_in_Microsoft_Power_Query 有关使用 Power Query 在 MS Excel 中使用 ESI 的信息(存档网页)

相关链接