catena-tools-core (v1)

How To Use The API Explorer

On the right hand side of this page, you will see a list of "Servers".

  • Mock server: This server will return mock responses to all requests. It is best used when evaluating the shape of the Catena API.
  • Localhost: This server will point at a locally running version of Catena. It is best used when you want to make real requests or to validate that Catena is properly running on your machine.
  • Custom Domain: This server will point at any domain you specify with the domain variable. It is best used when you have a version of Catena deployed to a live environment and you want to make real requests against it.

To configure which server is shown in example requests:

  1. Select the "Try it" button on any API operation within the API explorer
  1. Select your environment
  1. If you want to point the API explorer to an instance of Catena you have deployed, select "Custom Domain" and configure the domain environment variable.
  1. You're all set! This setting will be cached across all API operations exposed in these docs.
Languages
Servers
Mock server
https://docs.catenatools.com/_mock/apis/catena-tools-core/
Localhost
http://localhost:5000/
Custom Domain
https://{domain}/

CatenaApiKeys

CatenaApiKeys

Operations

TestApiKey is used to test the validity of an API key

Request

curl -i -X GET \
  https://docs.catenatools.com/_mock/apis/catena-tools-core/api/v1/api_keys/test

Responses

Success

Bodyapplication/json
object(Services.CatenaApiKeys.TestApiKeyResponse)
Response
application/json
{}

AdminGetApiKeyPermissions Gets a list of available permissions that can be attached to a policy for an API key

Request

curl -i -X GET \
  https://docs.catenatools.com/_mock/apis/catena-tools-core/api/v1/api_keys/permissions

Responses

Success

Bodyapplication/json
permissionsArray of objects(Catena.Core.TrustedServerPermission)
Response
application/json
{ "permissions": [ { … } ] }

AdminCreateApiKeyPolicy Creates a policy for use by one or more API keys

Request

Bodyapplication/json
namestring
permissionsArray of strings
curl -i -X POST \
  https://docs.catenatools.com/_mock/apis/catena-tools-core/api/v1/api_keys/policies \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "permissions": [
      "string"
    ]
  }'

Responses

Success

Bodyapplication/json
policyobject(Services.CatenaApiKeys.ApiKeyPolicy)
Response
application/json
{ "policy": { "id": "string", "name": "string", "permissions": [ … ] } }

AdminGetApiKeyPolicies Gets a list of policies that may be used by one or more API keys

Request

curl -i -X GET \
  https://docs.catenatools.com/_mock/apis/catena-tools-core/api/v1/api_keys/policies

Responses

Success

Bodyapplication/json
policiesArray of objects(Services.CatenaApiKeys.ApiKeyPolicy)
Response
application/json
{ "policies": [ { … } ] }

AdminUpdateApiKeyPolicy Updates a policy for use by one or more API keys

Request

Path
idstringrequired
Bodyapplication/json
idstring
namestring
permissionsArray of strings
curl -i -X PUT \
  'https://docs.catenatools.com/_mock/apis/catena-tools-core/api/v1/api_keys/policies/{id}' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "string",
    "name": "string",
    "permissions": [
      "string"
    ]
  }'

Responses

Success

Bodyapplication/json
policyobject(Services.CatenaApiKeys.ApiKeyPolicy)
Response
application/json
{ "policy": { "id": "string", "name": "string", "permissions": [ … ] } }

AdminDeleteApiKeyPolicy Deletes a policy for use by one or more API keys

Request

Path
idstringrequired
curl -i -X DELETE \
  'https://docs.catenatools.com/_mock/apis/catena-tools-core/api/v1/api_keys/policies/{id}'

Responses

Success

Bodyapplication/json
policyDeletedboolean
Response
application/json
{ "policyDeleted": true }

AdminCreateApiKey Creates an API key

Request

Bodyapplication/json
namestring
policyIdstring
curl -i -X POST \
  https://docs.catenatools.com/_mock/apis/catena-tools-core/api/v1/api_keys \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "policyId": "string"
  }'

Responses

Success

Bodyapplication/json
apiKeyobject(Services.CatenaApiKeys.ApiKey)
Response
application/json
{ "apiKey": { "key": "string", "name": "string", "createdOn": "string", "lastUsedOn": "string", "policy": { … } } }

AdminGetApiKeys Gets all API keys

Request

curl -i -X GET \
  https://docs.catenatools.com/_mock/apis/catena-tools-core/api/v1/api_keys

Responses

Success

Bodyapplication/json
apiKeysArray of objects(Services.CatenaApiKeys.ApiKey)
Response
application/json
{ "apiKeys": [ { … } ] }

AdminUpdateApiKey Updates an API key

Request

Path
keystringrequired
Bodyapplication/json
keystring
namestring
policyIdstring
curl -i -X PUT \
  'https://docs.catenatools.com/_mock/apis/catena-tools-core/api/v1/api_keys/{key}' \
  -H 'Content-Type: application/json' \
  -d '{
    "key": "string",
    "name": "string",
    "policyId": "string"
  }'

Responses

Success

Bodyapplication/json
apiKeyobject(Services.CatenaApiKeys.ApiKey)
Response
application/json
{ "apiKey": { "key": "string", "name": "string", "createdOn": "string", "lastUsedOn": "string", "policy": { … } } }

AdminDeleteApiKey Deletes an API key

Request

Path
keystringrequired
curl -i -X DELETE \
  'https://docs.catenatools.com/_mock/apis/catena-tools-core/api/v1/api_keys/{key}'

Responses

Success

Bodyapplication/json
apiKeyDeletedboolean
Response
application/json
{ "apiKeyDeleted": true }

CatenaAccounts

CatenaAccounts

Operations

CatenaServerManager

The server manager service portion of the integrated broker. This is what game servers interact with to handle matches.

Operations

CatenaAuthentication

CatenaAuthentication

Operations

CatenaSessions

A service that can be used to probe the session store directly for development or diagnostics. Not intended for regular production use!

Operations

CatenaTitles

CatenaTitles

Operations

CatenaServerReleases

CatenaServerManagement

Operations

CatenaPlatformAuth

A service for managing Catena-authoritative functionality with regards to validation and authentication. Used by validators in the Authentication service that log the user into the Catena platform.

Operations

CatenaParties

CatenaParties

Operations

CatenaNodeInspection

A service that can be used inspect the Catena node.

Operations

CatenaNodeControl

A service that can be used control the Catena node.

Operations

CatenaMatchBroker

An integrated match broker service which sits between the matchmaker, clients, and game servers/hosting to coordinate capacity and notify clients when servers are ready to accept connections. This implementation integrates the broker and capacity/server manager roles.

Operations

CatenaFriends

CatenaFriends

Operations

Events

Events

Operations

CatenaEntitlements

Operations

CatenaLeaderboards

Operations

CatenaMatchmaking

Operations

CatenaServerCatalog

Operations

CatenaSteamDiag

Operations