diff options
author | Douwe Maan <douwe@gitlab.com> | 2019-05-21 09:11:07 +0000 |
---|---|---|
committer | Douwe Maan <douwe@gitlab.com> | 2019-05-21 09:11:07 +0000 |
commit | 61c9edf63e0a121372b54b680ba0307f404f204a (patch) | |
tree | c326eebd38cfe84a99cab7355018e72ba486ebf2 | |
parent | bc6addf690ee5b098c912614f14a7fc81a1a8313 (diff) | |
parent | f5646b416e5ab821048d13034ff8bd8d0ff499d3 (diff) | |
download | gitlab-ce-61c9edf63e0a121372b54b680ba0307f404f204a.tar.gz |
Merge branch 'graphql-vision-docs' into 'master'
First pass at a graphql vision
See merge request gitlab-org/gitlab-ce!27959
-rw-r--r-- | doc/api/graphql/index.md | 15 |
1 files changed, 14 insertions, 1 deletions
diff --git a/doc/api/graphql/index.md b/doc/api/graphql/index.md index cf02bbd9c92..10e1ef0e533 100644 --- a/doc/api/graphql/index.md +++ b/doc/api/graphql/index.md @@ -16,6 +16,20 @@ added to the API without creating breaking changes. This allows us to have a versionless API as described in [the GraphQL documentation](https://graphql.org/learn/best-practices/#versioning). +## Vision + +We want the GraphQL API to be the **primary** means of interacting +programmatically with GitLab. To achieve this, it needs full coverage - anything +possible in the REST API should also be possible in the GraphQL API. + +To help us meet this vision, the frontend should use GraphQL in preference to +the REST API for new features, although the alpha status of GraphQL may prevent +this from being a possibility at times. + +There are no plans to deprecate the REST API. To reduce the technical burden of +supporting two APIs in parallel, they should share implementations as much as +possible. + ## Enabling the GraphQL feature The GraphQL API itself is currently in Alpha, and therefore hidden behind a @@ -32,7 +46,6 @@ curl --data "value=100" --header "PRIVATE-TOKEN: <your_access_token>" https://gi A first iteration of a GraphQL API includes the following queries 1. `project` : Within a project it is also possible to fetch a `mergeRequest` by IID. - 1. `group` : Only basic group information is currently supported. ## GraphiQL |