GraphQL

API Endpoints

Service

Endpoint URL

Description

GraphQL API

The main endpoint for all GraphQL queries and mutations.

Playground

An interactive web interface for exploring the schema and testing queries.


Authentication

Access to the Adanode API requires a unique API Key for authentication.

Get Your API Key

You can easily generate your API key through the official Adanode API Telegram Bot:

Follow the bot's instructions to register and generate your unique API key.

API Key Usage

The API Key must be included in the header of every request for successful authentication. You have two options for inclusion:

Header Name

Value Format

Example

X-API-Key

your-api-key-here

X-API-Key: a1b2c3d4e5f6g7h8i9j0

Authorization

Bearer your-api-key-here

Authorization: Bearer a1b2c3d4e5f6g7h8i9j0

Note: Replace your-api-key-here with the actual key you generated from the Telegram Bot.


Schema Download

Our GraphQL schema can be downloaded using graphqurl or graphql-inspector to facilitate local development, code generation, and schema analysis.

Since the schema requires authentication, you must include your API Key when performing introspection. The endpoint URL is: http://api.adanothe.com/graphql

# Download .graphql schema
pnpm dlx @graphql-inspector/cli \
  introspect https://api.adanothe.com/graphql \
  --header "X-API-Key: your-api-key-here" \
  --write schema.graphql

# Download .json schema
pnpm dlx @graphql-inspector/cli \
  introspect https://api.adanothe.com/graphql \
  --header "X-API-Key: your-api-key-here" \
  --write schema.json

Querying the API

To explore the available data fields, types, and operations (queries and mutations), we recommend using the GraphQL Playground.

The Playground provides:

  • An Editor to write and test your queries.

  • The Schema tab, which acts as comprehensive documentation for all available fields.

  • The Docs tab, which offers a browsable view of the schema.

For specific examples of queries and mutations, please refer to the Playground's documentation panel.

Last updated