mirror of
https://github.com/hasura/graphql-engine.git
synced 2024-12-16 09:51:59 +03:00
90f9806c99
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> GitOrigin-RevId: 581f08d36caf95d653fe88ee050b11f657614da4
176 lines
6.2 KiB
ReStructuredText
176 lines
6.2 KiB
ReStructuredText
.. meta::
|
|
:description: Hasura API reference
|
|
:keywords: hasura, docs, API, API reference
|
|
|
|
.. _api_reference:
|
|
|
|
API Reference
|
|
=============
|
|
|
|
.. contents:: Table of contents
|
|
:backlinks: none
|
|
:depth: 2
|
|
:local:
|
|
|
|
Available APIs
|
|
--------------
|
|
|
|
+----------------------------------+---------------------------------------------------+------------------+
|
|
| API | Endpoint | Access |
|
|
+==================================+===================================================+==================+
|
|
| GraphQL | :ref:`/v1/graphql <graphql_api>` | Permission rules |
|
|
+----------------------------------+---------------------------------------------------+------------------+
|
|
| Relay | :ref:`/v1beta1/relay <relay_api>` | Permission rules |
|
|
+----------------------------------+---------------------------------------------------+------------------+
|
|
| Legacy GraphQL | :ref:`/v1alpha1/graphql <graphql_api>` | Permission rules |
|
|
+----------------------------------+---------------------------------------------------+------------------+
|
|
| Schema *(> v2.0)* | :ref:`/v2/query <schema_api>` | Admin only |
|
|
+----------------------------------+---------------------------------------------------+------------------+
|
|
| Metadata *(> v2.0)* | :ref:`/v1/metadata <metadata_api>` | Admin only |
|
|
+----------------------------------+---------------------------------------------------+------------------+
|
|
| Schema/Metadata *(< v1.3)* | :ref:`/v1/query <schema_metadata_api>` | Admin only |
|
|
+----------------------------------+---------------------------------------------------+------------------+
|
|
| Restified GQL | :ref:`/api/rest <restified_api>` | GQL REST Routes |
|
|
+----------------------------------+---------------------------------------------------+------------------+
|
|
| Version | :ref:`/v1/version <version_api>` | Public |
|
|
+----------------------------------+---------------------------------------------------+------------------+
|
|
| Health | :ref:`/healthz <health_api>` | Public |
|
|
+----------------------------------+---------------------------------------------------+------------------+
|
|
| PG Dump | :ref:`/v1alpha1/pg_dump <pg_dump_api>` | Admin only |
|
|
+----------------------------------+---------------------------------------------------+------------------+
|
|
| Config | :ref:`/v1alpha1/config <config_api>` | Admin only |
|
|
+----------------------------------+---------------------------------------------------+------------------+
|
|
| Explain | :ref:`/v1/graphql/explain <explain_api>` | Admin only |
|
|
+----------------------------------+---------------------------------------------------+------------------+
|
|
|
|
.. _graphql_api:
|
|
|
|
GraphQL API
|
|
^^^^^^^^^^^
|
|
|
|
All GraphQL requests for queries, subscriptions and mutations are made to the GraphQL API.
|
|
|
|
See details at :ref:`api_reference_graphql`.
|
|
|
|
.. _relay_api:
|
|
|
|
Relay API
|
|
^^^^^^^^^
|
|
|
|
Hasura exposes a Relay schema for GraphQL requests for queries, subscriptions and mutations.
|
|
|
|
See docs at :ref:`relay_schema`.
|
|
|
|
See details at :ref:`api_reference_relay_graphql`.
|
|
|
|
.. _schema_api:
|
|
|
|
Schema API (v2.0 and above)
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Hasura exposes a schema API for directly executing SQL on the underlying Postgres.
|
|
|
|
This is primarily intended to be used as an ``admin`` API to manage the Hasura schema.
|
|
|
|
See details at :ref:`schema_apis`.
|
|
|
|
.. _metadata_api:
|
|
|
|
Metadata API (v2.0 and above)
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Hasura exposes a metadata API for managing metadata.
|
|
|
|
This is primarily intended to be used as an ``admin`` API to manage the Hasura metadata.
|
|
|
|
See details at :ref:`metadata_apis`.
|
|
|
|
.. _schema_metadata_api:
|
|
|
|
Schema / metadata API (v1.3 and below)
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Hasura exposes a schema / metadata API for managing metadata for permissions/relationships or for directly
|
|
executing SQL on the underlying Postgres.
|
|
|
|
This is primarily intended to be used as an ``admin`` API to manage the Hasura schema and metadata.
|
|
|
|
See details at :ref:`schema_metadata_apis` .
|
|
|
|
.. _version_api:
|
|
|
|
RESTified GraphQL API
|
|
^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Hasura allows saved GraphQL queries and mutations to be accesed through a REST interface.
|
|
|
|
See details at :ref:`restified_api_reference`.
|
|
|
|
.. _restified_api:
|
|
|
|
Version API
|
|
^^^^^^^^^^^
|
|
|
|
The ``/v1/version`` is a public endpoint that responds with the current server version in JSON format.
|
|
|
|
See details at :ref:`version_api_reference`.
|
|
|
|
.. _health_api:
|
|
|
|
Health check API
|
|
^^^^^^^^^^^^^^^^
|
|
|
|
The ``/healthz`` is a public endpoint that returns the server health status. There's also ``/hasura/healthz``
|
|
available as an alternative, which mirrors ``/healthz`` completely.
|
|
|
|
See details at :ref:`health_api_reference`.
|
|
|
|
.. _pg_dump_api:
|
|
|
|
pg_dump API
|
|
^^^^^^^^^^^
|
|
|
|
The ``/v1alpha1/pg_dump`` is an admin-only endpoint that can be used to execute
|
|
``pg_dump`` on the Postgres instance connected to Hasura. The ``pg_dump`` CLI
|
|
tool's argument can be passed as a POST request body to the API and the response
|
|
is sent back to the client.
|
|
|
|
See details at :ref:`pg_dump_api_reference`.
|
|
|
|
.. _config_api:
|
|
|
|
Config API
|
|
^^^^^^^^^^
|
|
|
|
``v1alpha1/config`` is an admin-only endpoint to get the current server
|
|
configuration.
|
|
|
|
See details at :ref:`config_api_reference`.
|
|
|
|
.. _explain_api:
|
|
|
|
Explain API
|
|
^^^^^^^^^^^
|
|
|
|
``v1/graphql/explain`` returns the Postgres plan for a query or subscription based
|
|
on the defined permissions.
|
|
|
|
See details at :ref:`explain_api_reference`.
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
:hidden:
|
|
|
|
GraphQL API <graphql-api/index>
|
|
Relay GraphQL API <relay-graphql-api/index>
|
|
Schema APIs (v2.0 and above) <schema-api/index>
|
|
Metadata APIs (v2.0 and above) <metadata-api/index>
|
|
Schema / Metadata APIs <schema-metadata-api/index>
|
|
RESTified GraphQL Endpoints <restified>
|
|
Version API <version>
|
|
Health check API <health>
|
|
PG Dump API <pgdump>
|
|
Config API <config>
|
|
Explain API <explain>
|
|
Common syntax definitions <syntax-defs>
|