Getting Started - Integrates API
This post will help you use Integrates API, which is built as a GraphQL service where you can consume data using a common query language. If you know how GraphQL works, you can skip ahead to Integrates API Token post:
- The first step is to get some GraphQL knowledge, how it works, and how to make queries to a GraphQL endpoint. You can do it in this Introduction on the official GraphQL site.
- Before you face the Integrates API, it is recommended to learn how to make Queries and Mutations since these are the basic operations over any GraphQL endpoint.
Once you get the basic knowledge about the main GraphQL concepts such as Queries, Mutations, Fields, and Arguments, you are ready to explore Integrates API:
Go to Integrates API Token post and use Browser method to see info about you (in this case, your role in the application; remember that you have to log in to Integrates previously):
query { me { role } }
If you want to get info about your projects, you can enhance the previous query. Remember that, since
Projects
is a list ofProject
entities, which are GraphQL entities, you must specify the items that you want from them, in this case, its names:query { me { projects { name } } }