mirror of
https://github.com/ToolJet/ToolJet
synced 2026-04-23 06:27:57 +00:00
bdfe3270e2
* docs: jira * docs: formatting + Client Credentials grant type * docs: connection string pgsql * docs: parameterized queries mysql * docs: parameterized queries in PostgreSQL * docs: update mysql example * docs: TJDB sql editor * docs: add metadata to REST API * docs: add, update postgresql media * docs: add metadata to graphql * docs: update parameterized queries * docs: add parameterized queries for mssql * docs: add SSL Cert to mysql * docs: TJDB SQL restricted commands * docs: update JIRA token location * docs: update delete issue example * docs: update find user by query example * docs: remove session id from get assignable users * docs: use correct image for get issues for board * docs: update create issue example * docs: update delete issue media * docs: update assignable users media * docs: update examples * docs: update key desc * docs: v2.68.0-Beta
42 lines
No EOL
1.6 KiB
Markdown
42 lines
No EOL
1.6 KiB
Markdown
---
|
|
id: openapi
|
|
title: OpenAPI
|
|
---
|
|
|
|
# OpenAPI
|
|
|
|
OpenAPI is a specification for designing and documenting RESTful APIs. Using OpenAPI datasource, ToolJet can generate REST API operations from OpenAPI Specs.
|
|
|
|
## Connection
|
|
|
|
To establish a connection with the OpenAPI global datasource, you can either click on the `+Add new global datasource` button located on the query panel or navigate to the **[Global Datasources](/docs/data-sources/overview)** page through the ToolJet dashboard.
|
|
|
|
- Connections are created based on OpenAPI specifications.
|
|
- The available authentication methods currently supported are Basic Auth, API Key, Bearer Token, and OAuth 2.0.
|
|
- It is also possible to use specifications that require multiple authentications. Learn more [here](https://swagger.io/docs/specification/authentication/).
|
|
|
|
:::info
|
|
OpenAPI datasource accepts specifications only in **JSON** and **YAML** formats.
|
|
:::
|
|
|
|
<div style={{textAlign: 'center'}}>
|
|
|
|
<img className="screenshot-full" src="/img/datasource-reference/openapi/openapiconnect-v2.png" alt="OpenAPI" />
|
|
|
|
</div>
|
|
|
|
## Querying OpenAPI
|
|
|
|
- Operations will be automatically generated from the specifications, and each operation will be distinct from others.
|
|
|
|
### Fields
|
|
|
|
- **Host** (Base URL): Some specifications may have one or multiple base URLs/servers, and certain operations might have separate base URLs. Therefore, you can choose the appropriate URL from the host selection.
|
|
|
|
- **Operation**
|
|
|
|
<div style={{textAlign: 'center'}}>
|
|
|
|
<img className="screenshot-full" src="/img/datasource-reference/openapi/query.png" alt="OpenAPI" />
|
|
|
|
</div> |