Epic Online Services (EOS) provides a ticketing system to support your products from a centralized location using an automatically generated, pre-assigned email address and a public web API key. The ticketing system supports:
- Tracking open, in-progress, and closed tickets
- Merging related tickets
- Replying to end-users who have submitted a ticket and receiving replies
Get Started
To use the ticketing system, you need to integrate it with your product through the Developer Portal.
- On the Developer Portal, select your product under the Your Products section in the left sidebar. If you haven't added your product to the Developer Portal yet, use the Create Product option to set it up first.
- Select Game Services and then Player Ticketing from the sidebar or the Player Ticketing tile from your product's main page to open the Player Ticketing page.
- This step is only required for a new product: Click the Integrate APIs button for integration before moving on to the next step.
- Click the Show API Key button to view the public web API key for the product. You need this key to implement the API. Each product has its own public web API key, but the system uses the same email address for all your products.
Using the API
The ticketing system sends emails from your end-users to your dedicated mailbox. To trigger this process, send a POST request to https://dev.epicgames.com/portal/api/v1/services/tickets/submit/ with your product's API key in the HTTP authorization field and the information that you want to report. The following fields are supported:
Field Name | Required | Description |
---|---|---|
subject | Yes | One of the following:
|
message | Yes | The email text, written by the end-user |
sender_email | Yes | The end-user's email address |
sender_name | No | The end-user's name |
guid | No | Your game's unique identifier for the end-user (e.g. the productUserId ) Note: Any type of unique identifier works, there are no restrictions enforced regarding the guid. |
error_code | No | An error code for technical support emails |
system_os | No | The end-user's operating system |
system_antimalware | No | The end-user's anti-malware system |
system_other | No | Other information about the end-user's system |
Placing a Request
To generate a ticket through cURL, place your request in the following format:
Once the system accepts the request, you will receive a response like this:
The system then creates a new ticket, which you can see by navigating to the ticketing system.
Export user data
In order to export a user’s data, for example to fulfill a GDPR request, send a GET request to https://dev.epicgames.com/portal/api/v1/services/tickets/datarights/{email}
with your product's API key in the HTTP authorization field and the user’s email for whom you wish to export the data in the URL path.
For example to export a user’s data through cURL, place your request in the following format:
Once the system accepts the request, you will receive a response like this with HTTP status code 200:
Delete user data
In order to delete a user’s data, for example to fulfill a GDPR request, send a DELETE request to https://dev.epicgames.com/portal/api/v1/services/tickets/datarights/{email}
with your product's API key in the HTTP authorization field and the user’s email for whom you wish to delete the data in the URL path.
For example to delete a user’s data through cURL, place your request in the following format:
Once the system accepts the request, you will receive a response with HTTP status code 204.
Usage Patterns, Restrictions, and Limitations
When placing requests through this system, observe the following limitations:
- Requests must come from websites or the game client.
- All requests must contain written material from the end-user.
- The number of requests produced in a day must not exceed 10,000, or 5 per 100 Daily Active Users.
- User data in this system has to be exported/deleted separately from other EOS services via the Export user data and Delete user data endpoints as described above.