debian-mirror-gitlab/lib/gitlab/graphql/docs/templates/default.md.haml

62 lines
1.9 KiB
Text
Raw Normal View History

2019-09-30 21:07:59 +05:30
-# haml-lint:disable UnnecessaryStringOutput
= auto_generated_comment
:plain
# GraphQL API Resources
This documentation is self-generated based on GitLab current GraphQL schema.
The API can be explored interactively using the [GraphiQL IDE](../index.md#graphiql).
2020-03-13 15:44:24 +05:30
Each table below documents a GraphQL type. Types match loosely to models, but not all
fields and methods on a model are available via GraphQL.
2020-04-08 14:13:33 +05:30
CAUTION: **Caution:**
Fields that are deprecated are marked with **{warning-solid}**.
2021-01-29 00:20:46 +05:30
Items (fields, enums, etc) that have been removed according to our [deprecation process](../index.md#deprecation-process) can be found
in [Removed Items](../removed_items.md).
2019-09-30 21:07:59 +05:30
\
2020-11-24 15:15:51 +05:30
:plain
## Object types
Object types represent the resources that GitLab's GraphQL API can return.
They contain _fields_. Each field has its own type, which will either be one of the
basic GraphQL [scalar types](https://graphql.org/learn/schema/#scalar-types)
(e.g.: `String` or `Boolean`) or other object types.
For more information, see
[Object Types and Fields](https://graphql.org/learn/schema/#object-types-and-fields)
on `graphql.org`.
\
2019-09-30 21:07:59 +05:30
- objects.each do |type|
- unless type[:fields].empty?
2020-11-24 15:15:51 +05:30
= render_name_and_description(type)
~ "| Field | Type | Description |"
~ "| ----- | ---- | ----------- |"
- sorted_by_name(type[:fields]).each do |field|
2020-04-08 14:13:33 +05:30
= render_field(field)
2019-09-30 21:07:59 +05:30
\
2020-11-24 15:15:51 +05:30
:plain
## Enumeration types
Also called _Enums_, enumeration types are a special kind of scalar that
is restricted to a particular set of allowed values.
For more information, see
[Enumeration Types](https://graphql.org/learn/schema/#enumeration-types)
on `graphql.org`.
\
- enums.each do |enum|
- unless enum[:values].empty?
= render_name_and_description(enum)
~ "| Value | Description |"
~ "| ----- | ----------- |"
- sorted_by_name(enum[:values]).each do |value|
= render_enum_value(value)
\