一图流API文档

HTTP GET

一图流API请求说明

注意事项	说明
请求 URL	/API路径?参数名=参数值&参数名=参数值......

HTTP POST

注意事项	说明
请求 URL	/API路径
请求体	请求体可以使用 JSON 也可以使用 Form 表单，一般为json

一图流API响应格式说明

一般情况下API无论GET、POST或其他请求，调用成功后返回的都是统一格式，格式如下

{
    "code": 200,
    "msg": "调用成功",
    "data": {}
}

统一响应格式字段说明

参数名	类型	参数说明
code	int	响应状态值
msg	string	响应信息
data	object	返回数据

因此文档后续除特殊情况外，只说明data（返回数据）内字段

公开的API

# 获取蓝材料推荐关 GET

用于获取蓝色品质材料的推荐关卡，排列顺序为关卡效率倒序

API路径

/stage/t3

请求参数

参数名	参数类型	参数说明	参数值
expCoefficient	double	经验书的价值系数

请求格式示例

https://backend.yituliu.site/stage/t3?expCoefficient=0.625

返回字段说明

关卡计算结果的字段

参数名	参数类型	参数说明
stageCode	string	关卡名称
stageId	string	关卡id
stageEfficiency	double	理智转化率
itemId	string	物品id
itemType	string	物品类型
apExpect	double	期望理智
knockRating	double	物品掉落概率
sampleConfidence	double	样本置信度
sampleSize	int	样本次数
secondary	string	副产物
secondaryId	string	副产物id
spm	double	每分钟消耗理智
stageColor	int	关卡标注颜色
updateTime	string	更新时间
zoneName	string	章节/活动名称

服务响应结果

返回消息体

{
    "code": 200,
    "msg": "调用成功",
    "data": {}
}

# 获取绿材料推荐关 GET

用于获取绿色品质材料的推荐关卡，排列顺序为材料期望理智升序

API路径

/stage/t2

请求参数

参数名	参数类型	参数说明	参数值
expCoefficient	double	经验书的价值系数

请求格式示例

https://backend.yituliu.site/stage/t2?expCoefficient=0.625

返回字段说明

关卡计算结果的字段

参数名	参数类型	参数说明
stageCode	string	关卡名称
stageId	string	关卡id
stageEfficiency	double	理智转化率
itemId	string	物品id
itemType	string	物品类型
apExpect	double	期望理智
knockRating	double	物品掉落概率
sampleConfidence	double	样本置信度
sampleSize	int	样本次数
secondary	string	副产物
secondaryId	string	副产物id
spm	double	每分钟消耗理智
stageColor	int	关卡标注颜色
updateTime	string	更新时间
zoneName	string	章节/活动名称

服务响应结果

返回消息体

{
    "code": 200,
    "msg": "调用成功",
    "data": {}
}

# 获取材料价值表 GET

用于获取各种常见精英化材料和其他材料的等效理智价值

API路径

/item/value

请求参数

参数名	参数类型	参数说明	参数值
expCoefficient	double	经验书的价值系数

请求格式示例

https://backend.yituliu.site/item/value?expCoefficient=0.625

返回字段说明

材料信息的字段

参数名	参数类型	参数说明
itemId	string	物品id
itemName	string	物品名称
itemValue	double	物品价值单位：绿票
itemValueAp	double	物品价值单位：理智
rarity	int	物品稀有度
weight	double	加工站爆率

服务响应结果

返回消息体

{
    "code": 200,
    "msg": "调用成功",
    "data": {}
}

# 获取往期活动关卡效率 GET

用于获取往期活动的活动关卡效率，仅返回掉落蓝色材料的关卡

API路径

/stage/closed

请求参数

参数名	参数类型	参数说明	参数值
expCoefficient	double	经验书的价值系数

请求格式示例

https://backend.yituliu.site/stage/closed?expCoefficient=0.625

返回字段说明

关卡计算结果的字段

参数名	参数类型	参数说明
stageCode	string	关卡名称
stageId	string	关卡id
stageEfficiency	double	理智转化率
itemId	string	物品id
itemType	string	物品类型
apExpect	double	期望理智
knockRating	double	物品掉落概率
sampleConfidence	double	样本置信度
sampleSize	int	样本次数
secondary	string	副产物
secondaryId	string	副产物id
spm	double	每分钟消耗理智
stageColor	int	关卡标注颜色
updateTime	string	更新时间
zoneName	string	章节/活动名称

服务响应结果

返回消息体

{
    "code": 200,
    "msg": "调用成功",
    "data": {}
}

# 获取搓玉推荐关卡 GET

用于获取游戏内所有可刷取关卡的搓玉效率，仅展示大于20%搓玉效率的关卡，排序顺序为搓玉效率倒序

API路径

/stage/orundum

请求参数

无参数

请求格式示例

https://backend.yituliu.site/stage/orundum

返回字段说明

关卡计算结果的字段

参数名	参数类型	参数说明
stageCode	string	关卡名称
orundumPerAp	double	1理智可得合成玉
orundumPerApEfficiency	double	搓玉效率(对比1-7)
stageEfficiency	double	关卡效率
lmdcost	double	龙门币消耗

服务响应结果

返回消息体

{
    "code": 200,
    "msg": "调用成功",
    "data": {}
}

# 获取常驻商店性价比 GET

用于获取采购中心常驻商店的性价比，返回的数据是key-value格式，key为商店代币的颜色（green为绿票商店），value是对应商店的性价比集合

API路径

/store/perm

请求参数

无参数

请求格式示例

https://backend.yituliu.site/store/perm

返回字段说明

(商店性价比字段)

参数名	参数类型	参数说明
storeType	string	商店类型
itemName	string	物品名称
itemId	string	物品id
cost	int	售价
costPer	double	性价比
quantity	int	售卖数量
rarity	int	物品星级

服务响应结果

返回消息体

{
    "code": 200,
    "msg": "调用成功",
    "data": {}
}