API Schemas

Headers

The Machina Sports API requires two HTTP headers:

• A Content-Type header specifying the request payload format
• A X-Api-Token header containing the authentication token for request authorization

curl --request POST \
  --url https://{api-address}.org.machina.gg/agent \
  --header 'Content-Type: application/json' \
  --header 'x-api-token: <api-key>' \
  --data '{}'

Sort, Filter and Paginate

The Machina Sports API works with sorting, filtering and paging for some larger requests. These mechanisms are defined in request body:

• The filters object defines filtering mechanism criteria
• The sorters array defines a sorting mechanism
  • First a property to defines sorting criteria
  • Second, 1 for ascending, -1 for descending
• The page and page_size properties defines specific page and the limit of items

{
  "filters": {
    "name": "Conversational Agent"
  },
  "sorters": [
    "_id",
    1
  ],
  "page": 1,
  "page_size": 10
}

Next up

Create API key to build an customized integration with Machina.