ReadyGamer API
Last updated
Last updated
Your game should do an HTTPS Post request to the endpoint that we will provide you in order to send the chat data. The URL that we will create for you will be in this format:
For example:
Method: POST
Headers: X-API-Key (Will be provided by Ready Gamer team separately)
Below is the list of the default parameters for a basic chat integration to the Ready Gamer API. In case your game needs to send additional data i.e. environment data, please contact us so we can tailor fit the endpoint for you.
text is the chat message coming from the user inside the game
userId is the user id of the player who's currently chatting with the agent npc..
userName is the name of the player who's currently chatting with the agent npc.
agentName is the name of the agent. This should be a unique value per specific agent. We will use this value to delegate the message to the corresponding agent.
For testing purposes, please use "test_ready_gamer_agent" as the agentName value.
agentId is the id of the agent relevant to the game. We added this to the template so that the game can properly delegate the message in case there are multiple instances of the same agent.
After calling the endpoint provided to you, the response will be in this format:
To prepare your agent for integration with the Ready Gamer API, your agent should have an endpoint with a capability to accept HTTPS POST requests in the format below.
message is the chat message coming from the game.
name_of_player is the name of the player who's currently chatting with the agent.
environment is a string containing information describing the current game state.
Regardless of what custom functions the agent was built to do, it should respond to the request in this format:
response is the processed message reply of the agent.
Once your agent endpoint is ready to accept this request, please contact us so we can connect you to the Ready Gamer API.