Pokko
  • Documentation
  • 📌Basic features
    • Data modelling
    • Media library
    • Querying content
    • Webhooks
  • 🦺Advanced features
    • Data model inheritance
    • Content hierarchy
    • Base values
    • Automatic fields
    • Content workflow
    • Modular content
    • Isolated environments
  • 🦮Guides
    • NextJS
Powered by GitBook
On this page
  • API Keys
  • Queries
  • Individual entries
  • Multiple entries
  • Caching
  • GraphQL endpoint

Was this helpful?

  1. Basic features

Querying content

How to extract published content out of Pokko

PreviousMedia libraryNextWebhooks

Last updated 3 years ago

Was this helpful?

API Keys

To query content you will need to set up an API key. This can be done from the project settings screen.

Click the "New token" button under the "API Tokens" section.

Click the "GraphQL Playground" button to open a website where you can start querying content.

In this UI you will need to specify the token that was generated.

Click "HTTP Headers" down the bottom and enter the following

{
  "X-Token": "<< API TOKEN >>"
}

With this in place, you can start querying your content.

Queries

There are two ways of querying your content.

  1. Querying individual pieces of content - entry()

  2. Querying a list of content of a specific type - entries { }

The GraphQL root query has two queries to access your content - entry and entries

More information about what queries are available can be found in the GraphQL Playground.

Individual entries

With entry you can query individual entries by ID or by Path.

query GetBlogPost {
  entry(id: "...") {
    ... on IBlogPost {
      id
      # additional fields here
    }
  }
}

Multiple entries

With entries you can query multiple entries of a type.

query ListBlogPosts {
  entries {
    allBlogPost(skip: 0, take: 10, filter: { ... }) {
      nodes {
        id
        # additional fields here
      }
      totalCount
    }
  }
}

Caching

A layer of caching is in place for the content querying endpoints. Content will be cached indefinitely until a change to your content is made. When a Publish occurs on an entry the cache will be cleared.

The more complex a GraphQL query is, the longer the initial request will take. Subsequent cached queries will be drastically faster.

GraphQL endpoint

POST https://<region>.pokko.io/:project/:environment/graphql

This endpoint allows you to get free cakes.

Path Parameters

Name
Type
Description

environment

string

project

string

Headers

Name
Type
Description

X-Token

string

📌
Click the cog here to access the project settings