Test Query — testQuery | Bifrost Developer Center

POSThttps://api.dev.bifrostgaming.com/v1/graphql

testQuery

Test your Guild API credentials with a simple query that returns a random word and confirms your access token is working.

Operation Type

Query

Rate Limit: 1 request per 60 seconds per guild

Intended for credential verification, not ongoing usage.

Code Examples

curl -X POST https://api.dev.bifrostgaming.com/v1/graphql \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ testQuery { success message randomWord timestamp guildId guildName } }"}'

Postman Collection

Download a ready-to-use Postman collection for this endpoint. Import it into Postman to start testing immediately.

How to import into Postman

Open Postman and click Import (top-left)
Drag and drop the downloaded .json file, or click Upload Files and select it
Click Import to confirm
The collection appears in your sidebar — expand it and select the request
In the Body tab, update the placeholder values (your-partner-id, etc.) with your actual credentials
Click Send

The collection uses Postman's GraphQL body type, which provides syntax highlighting and variable editing. Make sure your Postman version is 7.2+ for GraphQL support.

Success Response200

{
  "data": {
    "testQuery": {
      "success": true,
      "message": "API is operational",
      "randomWord": "bifrost",
      "timestamp": "2025-01-15T12:34:56.789Z",
      "guildId": "abc123-def456-ghi789",
      "guildName": "My Community"
    }
  }
}

Error Responses

Response Fields

Field	Type	Required	Description
`success`	Boolean	Optional	Always true when successful
`message`	String	Optional	Confirmation your token works
`randomWord`	String	Optional	Random word (changes each request)
`timestamp`	String	Optional	Current server time
`guildId`	String	Optional	Your guild's unique ID
`guildName`	String	Optional	Your guild's display name

In partnership with

Brilliant game servers for communities large and small.

Get yours today!

A Shrapnelworks product