国服在线: 0 | 世界服在线: 0 | 交通消息 | 增强信息 NEW | 参考消息 | 小工具集 | 人口普查 | 击杀榜

API 文档

EVE 国服市场数据中心提供与 eve-central 相兼容的 API 便于第三方工具调用. 当然一切还在逐步完善当中.

ChangeLog:

2021-07-12: 基础物品资料翻译更新到 YC123.6

2021-04-22: 基础物品资料翻译更新到 YC123.4

2020-10-21: 基础物品资料翻译更新到 YC122.10 (涅槃) 请留意星域星系空间站资料有更新

2020-08-26: 基础物品资料翻译更新到 YC122.8

2020-07-20: 基础物品资料翻译更新到 YC122.7

2020-04-27: 徇众要求, 基础物品资料翻译更新到 YC122.4, 今后依然会不定期更新.

2020-04-27: 徇众要求, 基础物品资料翻译更新到 YC122.4, 今后依然会不定期更新.

2020-03-16: 新的API后端上线测试, POST请求现在需要指定 Content-Type, 另外接口全面取消 JSONP 格式返回, 按照 CORS 的要求进行跨域访问处理.

2018-10-07: 由于基础数据变动频繁 今后基础物品资料翻译不再更新

2018-08-24: 添加物品搜索接口 文档全面使用HTTPS的地址

2016-10-18: 基础物品资料翻译更新到 YC118.8

2016-08-09: 基础物品资料翻译更新到 YC118.6

2016-06-22: 基础物品资料翻译更新到 YC118.5

更多...


基础资料

本压缩包中的Excel文档提供了所有的物品, 星域, 星座, 星系, NPC空间站资料(最后更新 2020-08-26)

下载: db_excel.7z


关于宁静

将地址中的api更改为tqapi可以获得宁静服务器的数据(测试中)

接口格式等不变


接口调用规范

一般的, 若果请求是POST请求, 那么需要显式指定Content-Type. 配合将来的接口更新, 将来的POST数据格式将会有更多可选择项.

如果为form(表单数据)格式, 其Content-Type是`application/x-www-form-urlencoded'


market

调用地址: https://www.ceve-market.org/api/market/

描述: 查询指定物品的价格资料.

调用方式: HTTP GET (RESTful)

返回格式: XML JSON AJAX(需申请)

REST URL 格式:

https://www.ceve-market.org/api/market/region/{星域ID}/system/{星系ID}/type/{物品ID}.{格式}

资源说明:

资源 描述 必要
物品ID 指定的物品ID, 如 三钛合金 为 34
星域ID 查询该指定星域
星系ID 查询该指定星系
返回格式 必须为 xml 或 json (全部小写)

返回值意义请直接阅读示例接口返回的数据

调用示例:

https://www.ceve-market.org/api/market/type/34.xml
https://www.ceve-market.org/api/market/region/10000002/type/34.json

关于跨域调用:

本接口可以提供 AJAX 跨域调用, 但为了减轻服务器负担, 需要事先申请, 申请后可以为指定的域名开放跨域调用权限

marketstat

调用地址: https://www.ceve-market.org/api/marketstat

描述: 查询指定物品的价格资料.

调用方式: HTTP GET, HTTP POST (form格式)

返回格式: XML

参数:

参数名 描述 必要 允许多次赋值
hours 查询 X 小时内的订单, 默认值为 8760
typeid 要查询的物品ID, 如 三钛合金 为 34, 可以多次赋值用于查询多件物品(最多20件)
minQ 最小订单可交易量. 对于卖单, 指订单剩余数量, 对于买单, 指最小可交易量. 默认值为 0
regionlimit 限定星域ID. 可以多次赋值用于限定多个星域, 默认值是所有星域
usesystem 限定星系. 如果要和 regionlimit 共用, 请保证该星系位于该星域下. 默认值是不限定

调用示例: https://www.ceve-market.org/api/marketstat?typeid=34&typeid=35&regionlimit=10000002&minQ=10000 , https://www.ceve-market.org/api/marketstat?typeid=34&usesystem=30000142

部分返回值说明

stddev: 带权重标准差
median: 带权重中位数
percentile: 带权重升序90百分位数


evemon

调用地址: https://www.ceve-market.org/api/evemon

描述: 查询吉他市场基础矿物的收购最高价.

调用方式: HTTP GET

返回格式: XML

参数: 本接口不需要参数


quicklook

调用地址: https://www.ceve-market.org/api/quicklook

描述: 查询指定物品的订单资料.

调用方式: HTTP GET, HTTP POST (form形式)

返回格式: XML

参数:

参数名 描述 必要 允许多次赋值
sethours 查询 X 小时内的订单, 默认值为 8760
typeid 要查询的物品ID, 如 三钛合金 为 34
setminQ 最小订单可交易量. 对于卖单, 指订单剩余数量, 对于买单, 指最小可交易量. 默认值为 0
regionlimit 限定星域ID. 可以多次赋值用于限定多个星域, 默认值是所有星域
usesystem 限定星系. 如果要和 regionlimit 共用, 请保证该星系位于该星域下. 默认值是不限定

调用示例: https://www.ceve-market.org/api/quicklook?typeid=34&regionlimit=10000002&setminQ=10000 , https://www.ceve-market.org/api/quicklook?typeid=34&usesystem=30000142

部分返回值说明

range: 收单范围, 0:本空间站, 32767:本星系, 65536:本星域, 其他数字为收单跳数


searchname

调用地址: https://www.ceve-market.org/api/searchname

描述: 按物品名搜索物品.

调用方式: HTTP POST (form形式)

返回格式: JSON

参数:

参数名 描述 必要 允许多次赋值
name 需查询的物品名


市场资料快照

所有市场资料每天快照存盘一次, 这里提供每天的快照下载.


开发人员注意: 旧接口迁移须知

从2012年9月29日开始, 所有的EVE国服市场中心接口域名从 cem.copyliu.org 变更为 www.ceve-market.org .

为了确保你的程序能正常运作, 请注意以下几点

  1. 即日起, 新域名接口已经启用. 请尽快为你的程序变更调用地址设置.
  2. 旧地址将会保持低效率运作直至2013年1月1日.
  3. 2013年1月1日后, 所有旧地址的 GET 请求将会被 HTTP 301 永久重定向到对应的新地址. 所有的 POST 请求将会返回 HTTP 410 永久失效.
  4. 最后, 旧地址将会完全失效. 该时间点将会另行通知.