一些说明
关于堡垒收录: 为贯彻本站一贯以来的中立性态度, 玩家堡垒有且只有完全公开的建筑物才会收录市场(卖单)数据. 如果您觉得有建筑物数据缺失, 请查询公开建筑物列表.
API 文档
EVE 国服市场数据中心提供与 eve-central 相兼容的 API 便于第三方工具调用. 当然一切还在逐步完善当中.
ChangeLog:
2023-02-11: 现在开始, 开始收录曙光服务器资料.
2022-05-19: 现在开始, 基础物品资料翻译将每天更新并生成excel文件.
2020-03-16: 新的API后端上线测试, POST请求现在需要指定 Content-Type, 另外接口全面取消 JSONP 格式返回, 按照 CORS 的要求进行跨域访问处理.
基础资料
本压缩包中的Excel文档提供了所有的物品, 星域, 星座, 星系, NPC空间站资料(每日更新)
下载: evedata.xlsx
关于曙光
将地址中的api更改为infapi可以获得曙光服务器的数据(测试中)
接口格式等不变
关于宁静
将地址中的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®ionlimit=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®ionlimit=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 .
为了确保你的程序能正常运作, 请注意以下几点
- 即日起, 新域名接口已经启用. 请尽快为你的程序变更调用地址设置.
- 旧地址将会保持低效率运作直至2013年1月1日.
- 2013年1月1日后, 所有旧地址的 GET 请求将会被 HTTP 301 永久重定向到对应的新地址. 所有的 POST 请求将会返回 HTTP 410 永久失效.
- 最后, 旧地址将会完全失效. 该时间点将会另行通知.