EpicGame免费游戏获取API集成文档
引言
在当今数字游戏产业迅速发展的背景下,Epic Games Store 凭借其独特的免费游戏策略吸引了大量玩家。每周,Epic Games 都会提供一款或多款免费游戏供玩家领取,这一策略不仅为玩家带来了实惠,也为开发者提供了展示作品的机会。为了更好地利用这一资源,许多开发者和游戏爱好者开始关注如何通过 API 接口自动化获取免费游戏信息。本文将详细介绍如何集成 Epic Games 免费游戏获取 API,并通过多个实际应用场景展示其强大的功能与灵活性。
快速开始
注册与认证
1.注册起零API服务平台(https://api.istero.com)
2.登录控制台,右上角--获取API的TOKEN密钥即可
接口地址
https://api.istero.com/resource/epic/free/game
请求参数
请求头部 | 值 | 说明 | 示例 |
---|---|---|---|
Authorization | TOKEN | 用户中心获取到的TOKEN | 89defae676abd3e3a42b41df17c40096 |
名称 | 类型 | 必填 | 默认值 | 描述 | 示例 |
---|---|---|---|---|---|
token | string | 否 | 无 | 如传入Authorization,此参数可以忽略 | 89defae676abd3e3a42b41df17c40096 |
GET请求实例
https://api.istero.com/resource/epic/free/game?token=TOKEN
响应数据
{
"code": 200,
"data": [
{
"title": "《Mortal Shell》",
"description": "《Mortal Shell》是一款深度动作类角色扮演游戏。在这个支离破碎的世界中,你的精神和适应能力都将受到严峻的挑战。你的对手们毫无怜悯之心,你需要超强的感知力、精准度和直觉才能在他们手下生存。控制死去的勇士,探索隐藏的圣所,直面强大的敌人。",
"publishDate": "2020-08-18 20:00:00",
"images": [
{
"type": "CodeRedemption_340x440",
"url": "https://cdn1.epicgames.com/salesEvent/salesEvent/c54f6d5f-2a48-41f9-9f36-38a441bdb535_1200x1600-8f81674351d5cbaa78be417ee078a80e"
},
{
"type": "Thumbnail",
"url": "https://cdn1.epicgames.com/salesEvent/salesEvent/c54f6d5f-2a48-41f9-9f36-38a441bdb535_1200x1600-8f81674351d5cbaa78be417ee078a80e"
},
{
"type": "OfferImageTall",
"url": "https://cdn1.epicgames.com/salesEvent/salesEvent/c54f6d5f-2a48-41f9-9f36-38a441bdb535_1200x1600-8f81674351d5cbaa78be417ee078a80e"
},
{
"type": "OfferImageWide",
"url": "https://cdn1.epicgames.com/salesEvent/salesEvent/066a34b0-e1dc-4eee-87f9-42b95d5238c6_2560x1440-60b72b7b1479ebafc188502d441c3ee5"
},
{
"type": "DieselStoreFrontTall",
"url": "https://cdn1.epicgames.com/salesEvent/salesEvent/c54f6d5f-2a48-41f9-9f36-38a441bdb535_1200x1600-8f81674351d5cbaa78be417ee078a80e"
},
{
"type": "DieselStoreFrontWide",
"url": "https://cdn1.epicgames.com/salesEvent/salesEvent/066a34b0-e1dc-4eee-87f9-42b95d5238c6_2560x1440-60b72b7b1479ebafc188502d441c3ee5"
}
],
"url": "https://store.epicgames.com/zh-CN/p/mortal-shell",
"price": "¥117.00",
"status": 1,
"startDate": "2025-03-13 23:00:00",
"endDate": "2025-03-20 23:00:00"
},
{
"title": "Jurassic World Evolution 2",
"description": "《侏罗纪世界:进化 2》是 Frontier 成就非凡的游戏《侏罗纪世界:进化》续作,以 2018 年极富开创性且充满沉浸感的管理模拟架构为基础进行开发,备受玩家期待。",
"publishDate": "2021-11-09 22:00:00",
"images": [
{
"type": "Thumbnail",
"url": "https://cdn1.epicgames.com/offer/4817ba5c11504724ba4d5817c8995dff/EGS_JurassicWorldEvolution2_FrontierDevelopments_S2_1200x1600-56055d1e93c502852ccc0f9578094e5d"
},
{
"type": "OfferImageTall",
"url": "https://cdn1.epicgames.com/offer/4817ba5c11504724ba4d5817c8995dff/EGS_JurassicWorldEvolution2_FrontierDevelopments_S2_1200x1600-56055d1e93c502852ccc0f9578094e5d"
},
{
"type": "OfferImageWide",
"url": "https://cdn1.epicgames.com/offer/4817ba5c11504724ba4d5817c8995dff/EGS_JurassicWorldEvolution2_FrontierDevelopments_S1_2560x1440-4103be22950c498c9687d9457d9e0815"
}
],
"url": "https://store.epicgames.com/zh-CN/p/jurassic-world-evolution-2",
"price": "¥163.00",
"status": 0,
"startDate": "2025-03-20 23:00:00",
"endDate": "2025-03-27 23:00:00"
},
{
"title": "Cat Quest II",
"description": "这是一款设定在猫狗世界的开放世界动作角色扮演游戏。在《Cat Quest 2》中,你可以独自游玩单人模式,也可以和一名好友一起游玩,并且你还能化身为猫咪和狗狗!在充满魔法的世界中展开任务、击败怪兽并收集战利品,踏上这段前所未有的猫咪冒险吧!",
"publishDate": "2024-05-02 23:00:00",
"images": [
{
"type": "OfferImageWide",
"url": "https://cdn1.epicgames.com/spt-assets/fe812f94c42e44e986691a84c796952d/cat-quest-ii-cj318.jpg"
},
{
"type": "OfferImageTall",
"url": "https://cdn1.epicgames.com/spt-assets/fe812f94c42e44e986691a84c796952d/cat-quest-ii-13gb6.jpg"
},
{
"type": "Thumbnail",
"url": "https://cdn1.epicgames.com/spt-assets/fe812f94c42e44e986691a84c796952d/cat-quest-ii-13gb6.jpg"
}
],
"url": "https://store.epicgames.com/zh-CN/p/cat-quest-ii-9dbefc",
"price": "¥47.00",
"status": 0,
"startDate": "2025-03-27 00:00:00",
"endDate": "2025-04-09 23:00:00"
},
{
"title": "World of Warships — Anniversary Party Favor",
"description": "Behold our token of appreciation for playing World of Warships at the Epic Games Store on this, our fourth anniversary on the platform!",
"publishDate": "2025-03-13 23:00:00",
"images": [
{
"type": "OfferImageWide",
"url": "https://cdn1.epicgames.com/spt-assets/4eb4296fe40e4130a61adbf2d6b34586/world-of-warships-1o35p.jpg"
},
{
"type": "OfferImageTall",
"url": "https://cdn1.epicgames.com/spt-assets/4eb4296fe40e4130a61adbf2d6b34586/world-of-warships-1550k.jpg"
},
{
"type": "Thumbnail",
"url": "https://cdn1.epicgames.com/spt-assets/4eb4296fe40e4130a61adbf2d6b34586/world-of-warships-1550k.jpg"
},
{
"type": "featuredMedia",
"url": "https://cdn1.epicgames.com/spt-assets/4eb4296fe40e4130a61adbf2d6b34586/world-of-warships-1ckhl.jpg"
},
{
"type": "featuredMedia",
"url": "https://cdn1.epicgames.com/spt-assets/4eb4296fe40e4130a61adbf2d6b34586/world-of-warships-xb89h.jpg"
}
],
"url": "https://store.epicgames.com/zh-CN/p/world-of-warships",
"price": "¥217.29",
"status": 1,
"startDate": "2025-03-13 23:00:00",
"endDate": "2025-03-20 23:00:00"
}
],
"message": "",
"elapsedTime": "1753.4ms"
}
响应数据说明
名称 | 描述 | ||
---|---|---|---|
code | 响应码 | ||
data | title | 游戏标题 | |
description | 游戏描述 | ||
publishDate | 发布时间 | ||
images | type | 图片类型 | |
url | 图片URL | ||
url | 游戏地址 | ||
price | 销售价格 | ||
status | 状态 0:即将免费 1:正在免费 | ||
startDate | 开始时间 | ||
endDate | 结束时间 | ||
message | 错误信息 | ||
elapsedTime | 响应耗时(ms) |
响应码参照
代码 | 描述 |
---|---|
200 | 数据返回成功 |
400 | 数据返回错误,“message”显示错误信息 |
401 | TOKEN为空 |
402 | 接口不存在 |
403 | 接口请求失败 |
404 | TOKEN错误/鉴权失败 |
405 | 白名单规则拦截 |
406 | 用户自主禁用TOKEN |
407 | 接口维护中 |
408 | 接口已停止服务 |
500 | 接口服务器错误 |
501 | 余额不足,仅付费接口会出现此状态码 |
502 | 违反平台协议,账号被封锁 |
503 | TOKEN安全规则限制 |
案例应用场景
1. 自动化游戏领取工具
开发者可以创建一个自动化工具,通过集成 Epic Games 免费游戏获取 API,定期检查并领取免费游戏。这不仅节省了玩家手动操作的时间,还能确保不错过任何一款免费游戏。例如,可以设置一个定时任务,每天或每周自动运行脚本,获取最新的免费游戏信息并自动完成领取操作。
2. 游戏推荐系统
通过分析 API 返回的游戏数据,开发者可以构建一个个性化的游戏推荐系统。该系统可以根据玩家的游戏历史、偏好和评分,推荐最适合的免费游戏。例如,系统可以筛选出与玩家已购买游戏类型相似的免费游戏,或者根据玩家的评价反馈推荐高评分的免费游戏。
3. 社区论坛与社交平台集成
游戏社区论坛或社交平台可以集成 Epic Games 免费游戏获取 API,实时更新并展示最新的免费游戏信息。例如,论坛可以在首页显著位置展示本周的免费游戏,并提供一键领取链接。这不仅增加了论坛的活跃度,还能吸引更多玩家参与讨论。
4. 数据分析与市场研究
企业和研究机构可以利用 API 获取大量的免费游戏数据,进行深入的数据分析和市场研究。例如,分析免费游戏的发布时间、类型分布、玩家反馈等,以了解市场趋势和玩家偏好。这些数据可以为游戏开发、市场营销策略提供有力的支持。
5. 教育与培训
在教育领域,教师可以利用 Epic Games 免费游戏获取 API 作为教学工具,帮助学生了解 API 集成、数据分析和自动化流程。例如,可以设计一个课程项目,要求学生通过 API 获取免费游戏数据,并构建一个简单的推荐系统或自动化领取工具。
结语
Epic Games 免费游戏获取 API 为开发者和游戏爱好者提供了强大的工具,能够自动化获取免费游戏信息,提升用户体验,并进行深入的数据分析。通过本文介绍的多个应用场景,我们可以看到,API 的集成不仅能够节省时间和精力,还能为游戏社区、市场研究、教育等领域带来巨大的价值。无论你是开发者、玩家还是研究者,掌握并利用这一 API 都将为你的项目和工作带来显著的提升。希望本文能够帮助你更好地理解和应用 Epic Games 免费游戏获取 API,开启你的自动化游戏之旅。