티케팅 시스템

자동 생성 및 사전 할당된 이메일 주소 및 공용 웹 API 키를 이용해 제품을 지원합니다.

에픽 온라인 서비스(Epic Online Services, EOS) 는 이메일 주소 및 공용 웹 API 키를 자동 생성 및 사전 할당해 한 곳에서 제품을 지원할 수 있도록 티케팅 시스템(Ticketing System) 을 제공합니다. 티케팅 시스템은 다음을 지원합니다.

  • 공개(open), 진행(in-progress), 완료(closed) 상태의 티켓을 추적합니다.

  • 관련 티켓을 병합합니다.

  • 티켓을 제출한 최종 사용자와 응답을 주고받습니다.

시작하기

티케팅 시스템을 사용하려면 개발자 포털(Developer Portal)을 통해 시스템과 제품을 연결해야 합니다.

  1. 개발자 포털에 접속한 뒤, 좌측 사이드바의 내 제품(Your Products) 섹션에서 제품을 선택합니다. 아직 개발자 포털에 추가한 제품이 없다면, 우선 제품 생성(Create Product) 옵션으로 제품을 추가합니다.

  2. 게임 서비스(Game Services) 를 선택한 후 사이드바에서 플레이어 티케팅(Player Ticketing) 을 선택하거나, 메인 페이지에서 플레이어 티케팅(Player Ticketing) 버튼을 눌러 플레이어 티케팅 페이지를 엽니다.

  3. 이 절차는 새 제품에만 필요합니다. 다음 절차로 넘어가기 전 API 통합(Integrate API) 버튼을 눌러 통합합니다.

  4. API 키 표시(Show API Key) 버튼을 눌러 제품의 공용 웹 API 키를 표시합니다. 이 키가 있어야 API를 구현할 수 있습니다. 제품마다 고유한 공용 웹 API 키가 있지만, 시스템에서는 모든 제품에 동일한 이메일 주소를 사용합니다.

API 사용하기

티케팅 시스템은 최종 사용자가 보낸 이메일을 여러분의 메일함으로 전송합니다. 해당 과정을 실행하려면 HTTP 인증 필드에 제품의 API 키를 기입하고 보내려는 정보를 작성한 뒤, https://dev.epicgames.com/portal/api/v1/services/tickets/submit/에 보내기(POST) 요청을 전송하세요. 지원하는 필드는 다음과 같습니다.

필드 이름

필수 입력 여부

설명

subject

필수

다음 중 하나를 선택합니다.

  • 공개 질문

  • 기술 지원

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 요청을 이행하기 위해 사용자 데이터를 익스포트하려면 HTTP 인증 필드에 제품의 API 키를 기입하고 데이터를 익스포트하려는 대상의 사용자 이메일을 URL 경로로 작성한 뒤 https://dev.epicgames.com/portal/api/v1/services/tickets/datarights/{email} 로 가져오기(GET) 요청을 전송하세요.

예를 들어 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 요청을 이행하기 위해 사용자 데이터를 삭제하려면 HTTP 인증 필드에 제품의 API 키를 기입하고 데이터를 삭제하려는 대상의 사용자 이메일을 URL 경로로 작성한 뒤 https://dev.epicgames.com/portal/api/v1/services/tickets/datarights/{email} 로 삭제(DELETE) 요청을 전송하세요.

예를 들어 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인 다음과 같은 응답을 받게 됩니다.

사용 패턴, 제약, 제한

해당 시스템으로 요청을 보낼 때는 다음 제한 사항을 준수하십시오.

  • 요청은 웹사이트나 게임 클라이언트에서 보내야 합니다.

  • 모든 요청에는 최종 사용자가 작성한 자료가 포함되어야 합니다.

  • 하루에 생성할 수 있는 요청 수는 총 10,000건 또는 일일 활성화 사용자 100명당 5건을 초과할 수 없습니다.

  • 해당 시스템의 사용자 데이터는 위에 설명된 대로 사용자 데이터 익스포트하기 및 사용자 데이터 삭제하기 엔드포인트를 통해 다른 EOS 서비스에서 따로 익스포트/삭제해야 합니다.

태그