申请单系统

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

利用 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'

系统接受请求后,你将收到一个 HTTP 状态码为200的响应,类似下面这个:

{
    "data": [
        {
            "guid": "example_guid",
            "subject": "technical-support: example game",
            "message": "Example ticket message",
            "sender_name": "Example User",
            "sender_email": "example@example.com",
            "timestamp": "2019-04-11T12:49:21.349000Z",
            "messages": [
                {
                    "ticket_id": 1,
                    "message": "Example reply 2",
                    "sender_name": "Example User",
                    "sender_email": "example@example.com",
                    "timestamp": "2019-04-11T12:54:21.463000Z"
                },
                {
                    "ticket_id": 1,
                    "message": "Example reply 1",
                    "sender_name": "Example Org Support",
                    "sender_email": "example_org@eos-external-support.mail.on.epicgames.com",
                    "timestamp": "2019-04-11T12:52:02.514000Z"
                }
            ]
        }
    ]
}

删除用户数据

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

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

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

系统接受请求后,你将收到一个 HTTP 状态码为204的响应。

使用模式、限制以及局限性

通过此系统发出请求时,请遵循下列限制:

  • 请求必须来自网站或游戏客户端。

  • 所有请求都必须包含来自最终用户的书面材料。

  • 单日生成的请求数量不能超过10000个、或每100名日常活跃用户生成5个的上限。

  • 系统中的用户数据必须通过上述的导出用户数据和删除用户数据端点与其他[EOS服务]分开导出/删除。

标签