Ticketing System

本系统使用自动生成的预指定邮件地址和公共网络API密钥,为你提供产品支持。

阅读时间4分钟

利用 Epic在线服务(EOS) 申请单(Ticketing System) 系统,即可使用自动生成的预指定邮件地址和公共网络API密钥,在集中位置提供产品支持。申请单系统当前支持以下功能:

  • 跟踪开启、进行中与关闭的申请单
  • 合并相关的申请单
  • 回复提交申请单的终端用户,并接收他们的回复

入门指南

要开始使用申请单系统,首先要通过开发者门户将其与你的产品整合起来。请根据以下步骤进行操作:

  1. 在开发者门户中,在左侧边栏的 你的产品(Your Products) 分段中找到你的产品。如你尚未将产品添加到开发者门户,则需要先通过 创建产品(Create Product) 进行设置。
  2. 从侧边栏选择 游戏服务(Game Services)玩家申请单(Player Ticketing),或在主窗口中选择 玩家申请单(Player Ticketing) 板块,进入玩家申请单页面。
  3. 这一步仅限新产品需要执行:点击右上角的 集成API(Integrate APIs) 按钮,然后继续下一步。
  4. 点击 显示API密钥(Show API Key) 按钮查看产品的公共网络API密钥。你将需要此键来实现API。每个产品都拥有其自身的公共网络API密钥;但对于不同产品,系统都会使用相同的电子邮件地址。

使用API

申请单系统将从终端用户发送电子邮件到你的专属邮箱。要触发此进程,在HTTP验证字段中填入你产品的API密钥,并填入需要报告的内容,将发布(POST)请求发送到 https://dev.epicgames.com/portal/api/v1/services/tickets/submit/。支持以下字段:

字段名是否必需描述
subject以下一项: * open-question(提出问题) * technical-support(技术支持)
message最终用户编写的邮件文本
sender_email最终用户的邮件地址
sender_name最终用户的名称
guid最终用户在游戏中的专属辨识符(例如 productUserId:任何可用的唯一识别符,关于guid,并没有硬性的限制措施。
error_code技术支持邮件的错误代码
system_os最终用户的操作系统
system_antimalware最终用户的反恶意软件系统
system_other关于最终用户的系统的其他信息

发出请求

要通过cURL发出请求并生成申请单,需遵循此格式:

curl -X POST \
https://dev.epicgames.com/portal/api/v1/services/tickets/submit/ \
-H 'Authorization: Token your_product_api_key_here' \
-H 'Content-Type: application/json' \
-d '{
"subject": "technical-support",
"message": "Example message.",
"sender_email": "example.user@example.domain",
"sender_name": "Example User",
"guid": "example_user_guid",
"error_code": "example error code",
"system_os": "example OS",
"system_antimalware": "example antimalware",
"system_other": "example system other"
}'

系统接受请求后则会发出如下响应:

{
"data": {
"prod_name": "example_game",
"prod_slug": "example_game_slug",
"guid": "example_user_guid",
"sender_name": "Example User",
"sender_email": "example.user@example.domain",
"subject": "Technical Support",
"message": "Example message.",
"error_code": "example error code",
"system_os": "example OS",
"system_antimalware": "example antimalware",
"system_other": "example system other",
"timestamp": "2019-03-07T14:20:10.933689Z",
}
}

系统之后会新建申请单,可前往申请单系统进行查看。

导出用户数据

需要导出用户数据时,比如要填充GDPR请求时,请向 https://dev.epicgames.com/portal/api/v1/services/tickets/datarights/{email} 发送一个GET请求,在HTTP授权字段中输入你的产品API密钥,在URL路径中输入你希望导出数据的用户邮箱。

举个例子,假如要通过cURL导出一个用户的数据,请以下列格式提交请求:

curl --location --request GET \
https://dev.epicgames.com/portal/api/v1/services/tickets/datarights/example@example.com \
-H 'Authorization: Token your_product_api_key_here' \
-H 'Content-Type: application/json'