ECO开放平台接入流程

应用场景
开放平台是面向开发者的统一生态入口，聚合出售商品、订单发货、多账号购买等功能，提交资料审核通过入驻后，即可调用接口创建交易。
提倡引导开发者通过官方接口获取信息，私自调用接口干扰网站或系统正常运营，将会被永久封禁。
出售：当需要出售大量饰品，并有开发基础可使用接口的情况，可申请开放能力，待审核通过后，可通过开放平台接口出售饰品。
购买：当需要为大量账号购买饰品，并有开发基础可使用接口的情况，可申请开放能力，待审核通过后，可通过开放平台接口购买。

申请接入流程

注册并登录ECOSteam App：

进入【我的】，点击右上角设置；

点击【账号与安全】进入；

点击【开放能力申请】进入介绍页面；

点击申请入驻；

填写申请资料并提交，回调地址和回调开关配置审核通过后可修改；

等待审核；

审核通过后流程

审核通过的用户，可回到页面点击【查看身份ID】；

输入RSA公钥后，获取身份ID；

如开启回调通知，则需配置回调地址和获取ECO的回调公钥；

身份ID（PartnerId）是与ECO开放平台交互的唯一标识，请妥善保管。若出现因身份ID泄露造成的损失由用户自行承担！如有服务器IP白名单校验需求可以联系ECO平台。

使用开发平台准备

功能列表	描述
RSA公私钥生成、签名	签名生成及参照示例
通用请求参数与响应	ECO开放平台所有接口请求参数与响应通用说明
回调通知服务	通过App设置回调地址，订单状态发生变化时，通过回调地址发送通知

注意：以下接口中如无特殊说明，返回的金额币种均为人民币（¥），整数部分单位是“元”，最高精确到小数点后2位数字，单位是“分”。

商户相关接口

功能列表	普通大客户频率	白名单大客户频率	描述
余额查询	5次/s	10次/s	查询ECO账户当前可用余额
获取资金流水	5次/s	10次/s	已授权的用户可通过此接口查询资金明细结果。
求购账户转入转出	1次/3s	1次/1s	通过此接口可以把余额转入求购余额或者把求购余额转出到余额
查询已绑定steam账号列表	1次/s	5次/s	查询当前已绑定的所有steam账号信息
验证交易链接	5次/s	10次/s	通过此接口查询指定交易链接状态
获取steamID	5次/s	10次/s	通过此接口查询指定交易链接对应的SteamID信息。

市场查询接口

功能列表	普通大客户频率	白名单大客户频率	描述
获取steam市场名称和在售价格(推荐)	5次/60s	10次/60s	通过此接口可以获取所有steam市场HashName和ECO在售商品数量及最低售价
品类查询(不推荐)	5次/s	10次/s	通过此接口可以获取指定类型下的商品列表
查询商品列表	5次/s	10次/s	通过此接口指定任意商品模板，接口返回指定模板下价格最低的50条商品
批量查询在售商品价格	5次/s	10次/s	通过此接口查询指定多个模板下的当前在售商品数量及在售最低价。
批量查询在售商品详情	5次/s	10次/s	通过此接口按照饰品类型或武器类型批量查询在售商品数量及在售最低价
批量查询在售商品状态	5次/s	10次/s	通过此接口最多可批量查询100个商品当前在售状态和价格
查询检视图	5次/s	10次/s	通过此接口获取对应商品的检视图

购买接口

功能列表	普通大客户频率	白名单大客户频率	描述
指定模板购买	10次/s	20次/s	通过此接口购买指定模板下，小于等于购买价格的最低价商品
指定商品购买	10次/s	20次/s	普通用户通过此接口购买指定的商品
预售商品购买	10次/s	20次/s	普通用户通过此接口购买指定的预售商品
P2P指定商品购买	10次/s	20次/s	已开通P2P交易用户通过此接口购买指定的商品

买家订单相关接口

功能列表	普通大客户频率	白名单大客户频率	描述
历史订单查询	5次/s	10次/s	通过此接口可查看最近31天内已完成的代购订单数据
查询订单状态	5次/s	10次/s	通过此接口批量查询购买订单当前的状态
查询购买订单列表	5次/s	10次/s	允许已授权的买家通过此接口查询ECO购买订单列表
查询订单详情	5次/s	10次/s	通过此接口查询购买订单的详情
查询报价信息	5次/s	10次/s	通过此接口查询购买订单的报价单号
买家取消订单	5次/s	10次/s	通过此接口可取消符合取消规则「规则见此接口详情」的订单
举报卖家撤回报价	5次/s	10次/s	允许买家通过此接口针对交易保护状态的订单举报卖家撤回报价
买家确认订单交易成功	5次/s	10次/s	允许买家通过此接口针对交易保护到期1天后未正常结束的订单确认交易成功

卖家订单相关接口

功能列表	普通大客户频率	白名单大客户频率	描述
查询出售订单列表	15次/s	30次/s	允许已授权的卖家通过此接口查询ECO出售订单列表。
卖家订单发送报价	5次/s	10次/s	允许已授权的用户通过此接口处理出售订单发送报价。
卖家订单接受报价	5次/s	10次/s	允许已授权的用户通过此接口处理出售订单发送报价。
一键处理报价	1次/5s	1次/10s	允许已授权的用户通过此接口一键处理当前用户需要发送和接受的报价。
卖家查询订单状态	5次/s	10次/s	新增支持查询出售订单状态。
卖家查询订单详情	5次/s	10次/s	新增支持查询出售订单详情。
卖家查询报价对应订单	5次/s	10次/s	允许已授权的用户通过此接口查询报价ID对应的ECO订单号。
预售订单修改收货交易链接	5次/s	10次/s	允许已授权的用户通过此接口修改预售订单的收货交易链接。

出售接口

功能列表	普通大客户频率	白名单大客户频率	描述
刷新用户Steam库存	5次/s	10次/s	允许已授权的用户通过此接口刷新Steam库存信息。
查询Steam库存	5次/s	10次/s	允许已授权的用户通过此接口查询已绑定的Steam库存。
出售商品列表	5次/s	10次/s	允许已授权的用户通过此接口查询用户所有在售商品。
上架库存饰品	5次/s	10次/s	允许已授权的用户通过此接口在ECO在售市场上架商品。
改价在售饰品	5次/s	10次/s	允许已授权的用户通过此接口改价在售商品。
预售饰品上架/改价	5次/s	10次/s	允许已授权的用户通过此接口上架或改价预售商品。
下架在售/预售饰品	5次/s	10次/s	允许已授权的用户通过此接口下架在售或预售商品。
设置店铺在线状态	1次/60s	1次/30s	允许已授权的用户通过此接口设置店铺在线或离线。

求购相关接口

功能列表	普通大客户频率	白名单大客户频率	描述
发布求购信息	5次/s	10次/s	允许已授权的用户通过此接口发布求购信息。
编辑求购信息	5次/s	10次/s	允许已授权的用户通过此接口编辑求购信息。
终止求购信息	5次/s	10次/s	允许已授权的用户通过此接口终止求购信息。
批量暂停/开启/删除求购信息	5次/s	10次/s	允许已授权的用户通过此接口批量更改求购状态。
批量更新求购收货链接	5次/s	10次/s	允许已授权的用户通过此接口批量更新求购交易链接。
获取我的求购分页列表	5次/s	10次/s	允许已授权的用户通过此接口查询当前正在求购的信息。
秒出货库存查询	5次/s	10次/s	允许已授权的用户通过此接口查询当前库存内可秒出货的资产。
秒出货求购供应	5次/s	10次/s	允许已授权的用户通过此接口供应求购出售资产。
Steam库存查询	5次/s	10次/s	允许已授权的用户通过此接口指定交易链接查询库存内可存款的饰品。
创建交易存款	5次/s	10次/s	允许已授权的用户通过此接口创建存款交易。
创建交易报价	5次/s	10次/s	允许已授权的用户通过此接口发送存款交易订单对应的报价。

出租接口

功能列表	普通大客户频率	白名单大客户频率	描述
可租可售上架/改价	5次/s	10次/s	允许已授权的用户通过此接口在ECO在售市场上架或改价可租可售商品。
下架出租商品	5次/s	10次/s	允许已授权的用户通过此接口在ECO在售市场下架出租商品。
可租可售上架/改价	5次/s	10次/s	允许已授权的用户通过此接口在ECO在售市场上架或改价商品，支持同时出售和出租。
查询自己出租的商品	5次/s	10次/s	允许已授权的用户通过此接口查询自己在ECO出租的商品。
查询出租订单列表	5次/s	10次/s	允许已授权的用户通过此接口查询卖家出租订单列表。
卖家查询出租订单详情	5次/s	10次/s	允许已授权的用户通过此接口查询卖家出租订单详细信息。

其它接口

功能列表	普通大客户频率	白名单大客户频率	描述
解封超时未收货用户	5次/s	10次/s	允许已授权的用户通过此接口解封由于所属订单导致的超时未收货用户惩罚。
获取交易汇率	5次/s	10次/s	提供ECO平台实时的人民币/美元换算汇率

已开通P2P交易的用户可以通过websocket监听商品变动信息：
WebSocket监听商品变动消息