國服在線: 0 | 世界服在線: 0 | 買單保證金: - | 賣單總價值: - | 交通消息 | 增强信息 NEW | 參考消息 | 小工具集 | 人口普查 | 擊殺榜

API 文檔

EVE 國服市場數據中心提供與 eve-central 相兼容的 API 便於第三方工具調用. 當然一切還在逐步完善當中.

ChangeLog:

2016-10-18: 基礎物品資料翻譯更新到 YC118.8

2016-08-09: 基礎物品資料翻譯更新到 YC118.6

2016-06-22: 基礎物品資料翻譯更新到 YC118.5

更多...


基礎資料

本壓縮包中的Excel文檔提供了所有的物品, 星域, 星座, 星系, NPC空間站資料

下載: db_excel.7z


接口調用規範

一般的, 若果請求是POST請求, 那麼需要顯式指定Content-Type. 配合將來的接口更新, 將來的POST數據格式將會有更多可選擇項.

如果為form(表單數據)格式, 其Content-Type是`application/x-www-form-urlencoded'


market

調用地址: http://www.ceve-market.org/api/market/

描述: 查詢指定物品的價格資料.

調用方式: HTTP GET (RESTful)

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

REST URL 格式:

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

資源說明:

資源 描述 必要
物品ID 指定的物品ID, 如 三钛合金 为 34
星域ID 查询该指定星域
星系ID 查询该指定星系
返回格式 必须为 xml 或 json (全部小写), 如果是 AJAX 跨域调用, 则添加参数 callback

調用示例:

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

关于跨域调用:

本接口可以提供 AJAX 跨域调用, 但为了减轻服务器负担, 需要事先申请, 申请后可以为指定的域名开放跨域调用权限, jQuery 调用示例
$.getJSON("http://www.ceve-market.org/api/market/region/10000002/system/30000142/type/34.json?callback=?",your_func);

marketstat

調用地址: http://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 共用, 請保證該星系位於該星域下. 默認值是不限定

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


evemon

調用地址: http://www.ceve-market.org/api/evemon

描述: 查詢吉他市場基礎礦物的收購最高價.

調用方式: HTTP GET

返回格式: XML

參數: 本接口不需要參數


quicklook

調用地址: http://www.ceve-market.org/api/quicklook

描述: 查詢指定物品的訂單資料.

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

返回格式: XML

參數:

參數名 描述 必要 允許多次賦值
sethours 查詢 X 小時內的訂單, 默認值為 8760
typeid 要查詢的物品ID, 如 三钛合金 為 34
setminQ 最小訂單可交易量. 對於賣單, 指訂單剩餘數量, 對於買單, 指最小可交易量. 默認值為 0
regionlimit 限定星域ID. 可以多次賦值用於限定多個星域, 默認值是所有星域
usesystem 限定星系. 如果要和 regionlimit 共用, 請保證該星系位於該星域下. 默認值是不限定

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


市場資料快照

所有市場資料每天快照存盤一次, 這裡提供每天的快照下載.


開發人員注意: 舊接口遷移須知

從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. 最後, 舊地址將會完全失效. 該時間點將會另行通知.