API routes
In this page, learn how to leverage the API routes to implement the User-Generated Emote feature in your game.
Last updated
Was this helpful?
In this page, learn how to leverage the API routes to implement the User-Generated Emote feature in your game.
Last updated
Was this helpful?
The OAuth 2.0 method of authentication consists in generating an authentication token. This can then be used as tokenized temporary credentials. The implicit flow is a browser only flow. It can be used in web applications that need access tokens and cannot make use of a backend. Ask for a client ID if you need to implement this flow.
GET
https://auth.kinetix.tech/login
Initiates user authentication and redirects to the pre-registered callback URL with the authentication token in the URL fragment.
client_id*
String
The ID of the requesting client
response_type*
String
Defines the flow type, here it's implicit flow: token
redirect_uri
String
The redirect_uri the client wants to redirect to
POST
https://sdk-api.kinetix.tech/v1/plans
Retrieves information about your current subscription plan. You can upgrade your plan at any time on the .
Content-Type: application/json
x-api-key*
GameAPIKey
Content-Type*
String
application/json
In this section, learn how to let your players communicate with our AI directly though your game, to create emotes.
GET
https://sdk-api.kinetix.tech/v1/process/token
Obtain a token to authenticate emote creation processes.
Content-Type*
String
application/json
x-api-key*
String
VirtualWorldKey
userId*
String
Virtual world's user ID
POST
https://sdk-api.kinetix.tech/v1/process
Initiates an ML process to generate a user-generated emote from a token.
Content-Type*
String
application/json
x-api-key*
String
VirtualWorldKey
x-api-token*
String
Token uuid
mature*
boolean
If the content is for adults only
start*
example":"00:00:00.000
Start time of video
end*
example":"00:00:02.000
End time of video
name*
String
Name of the emote to create
video*
Video file
Supported : AVI, FLV, MKV, MP4, TS, MOV, WebM
GET
https://sdk-api.kinetix.tech/v1/process/{uuid}
Get a user process status. The user must be associated to requesting virtual world
Content-Type*
String
application/json
x-api-key*
String
VirtualWorldKey
uuid*
String
The process uuid returned by the POST /v1/process route.
POST
https://sdk-api.kinetix.tech/v1/process/{uuid}/validate
Content-Type*
String
application/json
x-api-key*
String
VirtualWorldKey
uuid*
String
The process uuid returned by the POST /v1/process route.
POST
https://sdk-api.kinetix.tech/v1/process/{uuid}/retake
When the validation flow is activated, this will reject the process and return a new generation token to let the user retry. If you want to let your users the capacity to retake an emote, you have to let them validate or not an emote when it's generated. It means that, after generating an emote, players will have two options: validate the process if they're satisfied with the emote output they received, or retake the process.
Content-Type*
String
application/json
x-api-key*
String
VirtualWorldKey
uuid*
String
The process uuid returned by the POST /v1/process route.
GET
https://sdk-api.kinetix.tech/v1/process/token/{token}
Determines the status of a previously generated token.
Content-Type*
String
application/json
x-api-key*
String
VirtualWorldKey
token*
String
Token generated
userId*
String
Virtual world's user ID
GET
https://sdk-api.kinetix.tech/v1/process/dev-token
Create a QR code for the specified user. By default, it will use the virtual world id 1. Virtual World can be changed by specifying one of its keys.
Content-Type*
String
application/json
x-api-key*
String
VirtualWorldKey
userId*
String
Virtual world's user ID
Virtual world's key
String
If you want to let your users the capacity to retake an emote, you have to let them validate or not an emote when it's generated. It means that, after generating an emote, players will have two options: validate the process if they're satisfied with the emote output they received, or retake the process. Note that for now, you cannot benefit from the validate/retake process on your own: you have to ask to activate it for you. When the validation flow is activated, this will make the emote available to the user.