Influxdata
/
docs-v2
mirror of https://github.com/influxdata/docs-v2.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

hotfix(api): add info content for v2.4 API (#4391) 

* hotfix(api): add info content for v2.4 API

* Update api-docs/openapi/content/v2.4/v1compat/info.yml

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>
pull/4397/head^2
Jason Stirnaman 2022-08-29 15:15:02 -05:00 committed by GitHub
parent 7dec46bc7c
commit 272b19b259
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 30 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
api-docs/README.md
View File

@ -102,15 +102,24 @@
mkdir v2.3 mkdir v2.3
``` ```
8. Enter the following commands into your terminal to fetch and process the contracts: 8. Copy custom content from the previous version--for example:
```sh
# In your terminal, copy the `docs-v2/api-docs/openapi/content/v2.2` directory to a new directory:
cp -r ./openapi/content/v2.2 ./openapi/content/v2.3
# TODO: We can probably automate this step now since we pass the version number.
```
9. Enter the following commands into your terminal to fetch and process the contracts:
```sh ```sh
# Fetch the contracts, apply customizations, and bundle. # Fetch the contracts, apply customizations, and bundle.
sh getswagger.sh oss sh getswagger.sh oss
``` ```
9. To generate the HTML files for local testing, follow the instructions to [generate API docs locally](#generate-api-docs-locally). 10. To generate the HTML files for local testing, follow the instructions to [generate API docs locally](#generate-api-docs-locally).
10. To commit your updated spec files, push your branch to `influxdata/docs-v2`, and create a PR against the `master` branch. 11. To commit your updated spec files, push your branch to `influxdata/docs-v2`, and create a PR against the `master` branch.
## Update API docs for OSS spec changes between releases ## Update API docs for OSS spec changes between releases

7
api-docs/openapi/content/v2.4/info.yml Normal file
View File

@ -0,0 +1,7 @@
title: InfluxDB OSS API Service
version: 2.4.0
description: |
The InfluxDB v2 API provides a programmatic interface for all interactions with InfluxDB. Access the InfluxDB API using the `/api/v2/` endpoint.
This documentation is generated from the
[InfluxDB OpenAPI specification](https://github.com/influxdata/openapi/blob/influxdb-oss-v2.4.0/contracts/ref/oss.yml).

9
api-docs/openapi/content/v2.4/v1compat/info.yml Normal file
View File

@ -0,0 +1,9 @@
title: InfluxDB OSS v1 compatibility API documentation
version: 2.4.0 v1 compatibility
description: |
The InfluxDB 1.x compatibility /write and /query endpoints work with InfluxDB 1.x client libraries and third-party integrations like Grafana and others.
If you want to use the latest InfluxDB /api/v2 API instead, see the [InfluxDB v2 API documentation](/influxdb/v2.4/api/).
This documentation is generated from the
[InfluxDB OpenAPI specification](https://github.com/influxdata/openapi/blob/influxdb-oss-v2.4.0/contracts/swaggerV1Compat.yml).