Knowde API Documentation Overview

Introduction to API

We appreciate your interest in the Knowde API, which provides both REST and GraphQL options for managing your data on the Knowde Platform.

Using the Knowde API Reference

REST

The Knowde API is organized around RESTful resources. Our API has predictable resource-oriented URLs, accepts JSON-encoded payloads, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

When using the Knowde API, you have an option to work in our staging environment to build and test your integration without affecting your live data or interacting with production systems.

GraphQL

GraphQL is a query language for APIs and a runtime for fulfilling those queries with your existing data. GraphQL provides a complete and understandable description of the data in your API, gives clients the power to ask for exactly what they need and nothing more, makes it easier to evolve APIs over time, and enables powerful developer tools.

We recommend using our GraphQL API as the primary means of interacting programmatically with Knowde. To achieve this, it needs full coverage - anything possible in the REST API should also be possible in the GraphQL API.

Working with GraphQL

If you’re new to using GraphQL, you can visit the GraphQL documentation site or view the available resources in the GraphQL API reference. The reference is automatically generated from the Knowde GraphQL schema and exported as the standard GraphQL SDL file. For integrating with the GraphQL in a Javascript or NodeJS app, we would suggest using the Apollo Client. It is a fully featured API client complete with denormalized cache that allows for seamless integration and data management in any frontend app.