mirror of
https://github.com/jlengrand/jetbrains-client-api-repository.git
synced 2026-03-10 08:31:24 +00:00
Adding OpenAQ
This commit is contained in:
51
apis/openaq/Apis/V1Api.http
Normal file
51
apis/openaq/Apis/V1Api.http
Normal file
@@ -0,0 +1,51 @@
|
||||
## V1Api
|
||||
|
||||
### Get cities
|
||||
## Get cities
|
||||
GET https://api.openaq.org/v1/cities
|
||||
Accept: application/json
|
||||
|
||||
### Get country by ID
|
||||
## Get country by ID
|
||||
GET https://api.openaq.org/v1/countries/{{country_id}}
|
||||
Accept: application/json
|
||||
|
||||
### Get countries
|
||||
## Get countries
|
||||
GET https://api.openaq.org/v1/countries
|
||||
Accept: application/json
|
||||
|
||||
### Get latest measurements
|
||||
## Get latest measurements
|
||||
GET https://api.openaq.org/v1/latest
|
||||
Accept: application/json
|
||||
|
||||
### Get latest measurements by location ID
|
||||
## Get latest measurements by location ID
|
||||
GET https://api.openaq.org/v1/latest/{{location_id}}
|
||||
Accept: application/json
|
||||
|
||||
### Get locations
|
||||
## Get locations
|
||||
GET https://api.openaq.org/v1/locations
|
||||
Accept: application/json
|
||||
|
||||
### Get location by ID
|
||||
## Get location by ID
|
||||
GET https://api.openaq.org/v1/locations/{{location_id}}
|
||||
Accept: application/json
|
||||
|
||||
### Get a list of measurements
|
||||
## Get a list of measurements
|
||||
GET https://api.openaq.org/v1/measurements
|
||||
Accept: application/json
|
||||
|
||||
### Get parameters
|
||||
## Get parameters
|
||||
GET https://api.openaq.org/v1/parameters
|
||||
Accept: application/json
|
||||
|
||||
### Sources
|
||||
## Sources
|
||||
GET https://api.openaq.org/v1/sources
|
||||
Accept: application/json
|
||||
87
apis/openaq/Apis/V2Api.http
Normal file
87
apis/openaq/Apis/V2Api.http
Normal file
@@ -0,0 +1,87 @@
|
||||
## V2Api
|
||||
|
||||
### Get averaged values
|
||||
## Get averaged values
|
||||
GET https://api.openaq.org/v2/averages
|
||||
Accept: application/json
|
||||
|
||||
### Get cities
|
||||
## Get cities
|
||||
GET https://api.openaq.org/v2/cities
|
||||
Accept: application/json
|
||||
|
||||
### Get country by ID
|
||||
## Get country by ID
|
||||
GET https://api.openaq.org/v2/countries/{{country_id}}
|
||||
Accept: application/json
|
||||
|
||||
### Get countries
|
||||
## Get countries
|
||||
GET https://api.openaq.org/v2/countries
|
||||
Accept: application/json
|
||||
|
||||
### Get latest measurements
|
||||
## Get latest measurements
|
||||
GET https://api.openaq.org/v2/latest
|
||||
Accept: application/json
|
||||
|
||||
### Get latest measurements by location ID
|
||||
## Get latest measurements by location ID
|
||||
GET https://api.openaq.org/v2/latest/{{location_id}}
|
||||
Accept: application/json
|
||||
|
||||
### Get locations
|
||||
## Get locations
|
||||
GET https://api.openaq.org/v2/locations
|
||||
Accept: application/json
|
||||
|
||||
### Get a location by ID
|
||||
## Get a location by ID
|
||||
GET https://api.openaq.org/v2/locations/{{location_id}}
|
||||
Accept: application/json
|
||||
|
||||
### Get measurements
|
||||
## Get measurements
|
||||
GET https://api.openaq.org/v2/measurements
|
||||
Accept: application/json
|
||||
|
||||
### Get manufacturers
|
||||
## Get manufacturers
|
||||
GET https://api.openaq.org/v2/manufacturers
|
||||
Accept: application/json
|
||||
|
||||
### Get models
|
||||
## Get models
|
||||
GET https://api.openaq.org/v2/models
|
||||
Accept: application/json
|
||||
|
||||
### Get parameters
|
||||
## Get parameters
|
||||
GET https://api.openaq.org/v2/parameters
|
||||
Accept: application/json
|
||||
|
||||
### Projects
|
||||
## Projects
|
||||
GET https://api.openaq.org/v2/projects
|
||||
Accept: application/json
|
||||
|
||||
### Project by ID
|
||||
## Project by ID
|
||||
GET https://api.openaq.org/v2/projects/{{project_id}}
|
||||
Accept: application/json
|
||||
|
||||
### Source Readme
|
||||
## Source Readme
|
||||
GET https://api.openaq.org/v2/sources/readme/{{slug}}
|
||||
Accept: text/html
|
||||
Accept: application/json
|
||||
|
||||
### Sources
|
||||
## Sources
|
||||
GET https://api.openaq.org/v2/sources
|
||||
Accept: application/json
|
||||
|
||||
### Platform Summary
|
||||
## Platform Summary
|
||||
GET https://api.openaq.org/v2/summary
|
||||
Accept: application/json
|
||||
71
apis/openaq/README.md
Normal file
71
apis/openaq/README.md
Normal file
@@ -0,0 +1,71 @@
|
||||
# OpenAQ - Jetbrains API Client
|
||||
|
||||
## General API description
|
||||
|
||||
OpenAQ API - https://docs.openaq.org
|
||||
|
||||
* API basepath : [https://api.openaq.org](https://api.openaq.org)
|
||||
* Version : 2.0.0
|
||||
|
||||
## Documentation for API Endpoints
|
||||
|
||||
All URIs are relative to *https://api.openaq.org*, but will link to the `.http` file that contains the endpoint definition.
|
||||
There may be multiple requests for a single endpoint, one for each example described in the OpenAPI specification.
|
||||
|
||||
Class | Method | HTTP request | Description
|
||||
------------ | ------------- | ------------- | -------------
|
||||
*V1Api* | [**citiesGetv1V1CitiesGet**](Apis/V1Api.http#citiesgetv1v1citiesget) | **GET** /v1/cities | Get cities
|
||||
*V1Api* | [**countriesGetV1CountriesCountryIdGet**](Apis/V1Api.http#countriesgetv1countriescountryidget) | **GET** /v1/countries/{country_id} | Get country by ID
|
||||
*V1Api* | [**countriesGetv1V1CountriesGet**](Apis/V1Api.http#countriesgetv1v1countriesget) | **GET** /v1/countries | Get countries
|
||||
*V1Api* | [**latestV1GetV1LatestGet**](Apis/V1Api.http#latestv1getv1latestget) | **GET** /v1/latest | Get latest measurements
|
||||
*V1Api* | [**latestV1GetV1LatestLocationIdGet**](Apis/V1Api.http#latestv1getv1latestlocationidget) | **GET** /v1/latest/{location_id} | Get latest measurements by location ID
|
||||
*V1Api* | [**locationsv1GetV1LocationsGet**](Apis/V1Api.http#locationsv1getv1locationsget) | **GET** /v1/locations | Get locations
|
||||
*V1Api* | [**locationsv1GetV1LocationsLocationIdGet**](Apis/V1Api.http#locationsv1getv1locationslocationidget) | **GET** /v1/locations/{location_id} | Get location by ID
|
||||
*V1Api* | [**measurementsGetV1V1MeasurementsGet**](Apis/V1Api.http#measurementsgetv1v1measurementsget) | **GET** /v1/measurements | Get a list of measurements
|
||||
*V1Api* | [**parametersGetv1V1ParametersGet**](Apis/V1Api.http#parametersgetv1v1parametersget) | **GET** /v1/parameters | Get parameters
|
||||
*V1Api* | [**sourcesV1GetV1SourcesGet**](Apis/V1Api.http#sourcesv1getv1sourcesget) | **GET** /v1/sources | Sources
|
||||
*V2Api* | [**averagesV2GetV2AveragesGet**](Apis/V2Api.http#averagesv2getv2averagesget) | **GET** /v2/averages | Get averaged values
|
||||
*V2Api* | [**citiesGetV2CitiesGet**](Apis/V2Api.http#citiesgetv2citiesget) | **GET** /v2/cities | Get cities
|
||||
*V2Api* | [**countriesGetV2CountriesCountryIdGet**](Apis/V2Api.http#countriesgetv2countriescountryidget) | **GET** /v2/countries/{country_id} | Get country by ID
|
||||
*V2Api* | [**countriesGetV2CountriesGet**](Apis/V2Api.http#countriesgetv2countriesget) | **GET** /v2/countries | Get countries
|
||||
*V2Api* | [**latestGetV2LatestGet**](Apis/V2Api.http#latestgetv2latestget) | **GET** /v2/latest | Get latest measurements
|
||||
*V2Api* | [**latestGetV2LatestLocationIdGet**](Apis/V2Api.http#latestgetv2latestlocationidget) | **GET** /v2/latest/{location_id} | Get latest measurements by location ID
|
||||
*V2Api* | [**locationsGetV2LocationsGet**](Apis/V2Api.http#locationsgetv2locationsget) | **GET** /v2/locations | Get locations
|
||||
*V2Api* | [**locationsGetV2LocationsLocationIdGet**](Apis/V2Api.http#locationsgetv2locationslocationidget) | **GET** /v2/locations/{location_id} | Get a location by ID
|
||||
*V2Api* | [**measurementsGetV2MeasurementsGet**](Apis/V2Api.http#measurementsgetv2measurementsget) | **GET** /v2/measurements | Get measurements
|
||||
*V2Api* | [**mfrGetV2ManufacturersGet**](Apis/V2Api.http#mfrgetv2manufacturersget) | **GET** /v2/manufacturers | Get manufacturers
|
||||
*V2Api* | [**modelGetV2ModelsGet**](Apis/V2Api.http#modelgetv2modelsget) | **GET** /v2/models | Get models
|
||||
*V2Api* | [**parametersGetV2ParametersGet**](Apis/V2Api.http#parametersgetv2parametersget) | **GET** /v2/parameters | Get parameters
|
||||
*V2Api* | [**projectsGetV2ProjectsGet**](Apis/V2Api.http#projectsgetv2projectsget) | **GET** /v2/projects | Projects
|
||||
*V2Api* | [**projectsGetV2ProjectsProjectIdGet**](Apis/V2Api.http#projectsgetv2projectsprojectidget) | **GET** /v2/projects/{project_id} | Project by ID
|
||||
*V2Api* | [**readmeGetV2SourcesReadmeSlugGet**](Apis/V2Api.http#readmegetv2sourcesreadmeslugget) | **GET** /v2/sources/readme/{slug} | Source Readme
|
||||
*V2Api* | [**sourcesGetV2SourcesGet**](Apis/V2Api.http#sourcesgetv2sourcesget) | **GET** /v2/sources | Sources
|
||||
*V2Api* | [**summaryGetV2SummaryGet**](Apis/V2Api.http#summarygetv2summaryget) | **GET** /v2/summary | Platform Summary
|
||||
|
||||
|
||||
## Usage
|
||||
|
||||
### Prerequisites
|
||||
|
||||
You need [IntelliJ](https://www.jetbrains.com/idea/) to be able to run those queries. More information can be found [here](https://www.jetbrains.com/help/idea/http-client-in-product-code-editor.html).
|
||||
You may have some luck running queries using the [Code REST Client](https://marketplace.visualstudio.com/items?itemName=humao.rest-client) as well, but your mileage may vary.
|
||||
|
||||
### Variables and Environment files
|
||||
|
||||
* Generally speaking, you want queries to be specific using custom variables. All variables in the `.http` files have the `` format.
|
||||
* You can create [public or private environment files](https://www.jetbrains.com/help/idea/exploring-http-syntax.html#environment-variables) to dynamically replace the variables at runtime.
|
||||
|
||||
_Note: don't commit private environment files! They typically will contain sensitive information like API Keys._
|
||||
|
||||
### Customizations
|
||||
|
||||
If you have control over the generation of the files here, there are two main things you can do
|
||||
|
||||
* Select elements to replace as variables during generation. The process is case-sensitive. For example, API_KEY ->
|
||||
* For this, run the generation with the `bodyVariables` property, followed by a "-" separated list of variables
|
||||
* Example: `--additional-properties bodyVariables=YOUR_MERCHANT_ACCOUNT-YOUR_COMPANY_ACCOUNT-YOUR_BALANCE_PLATFORM`
|
||||
* Add custom headers to _all_ requests. This can be useful for example if your specifications are missing [security schemes](https://github.com/github/rest-api-description/issues/237).
|
||||
* For this, run the generation with the `customHeaders` property, followed by a "&" separated list of variables
|
||||
* Example : `--additional-properties=customHeaders="Cookie:X-API-KEY="&"Accept-Encoding=gzip"`
|
||||
|
||||
_This client was generated by the [jetbrains-http-client](https://openapi-generator.tech/docs/generators/jetbrains-http-client) generator of OpenAPI Generator_
|
||||
10
apis/openaq/runDocker.sh
Executable file
10
apis/openaq/runDocker.sh
Executable file
@@ -0,0 +1,10 @@
|
||||
#!/bin/sh
|
||||
|
||||
# File comes from https://docs.openaq.org/docs/postman-collection
|
||||
|
||||
docker run --rm \
|
||||
-v ${PWD}:/local julienlengrand/jetbrains-openapi-generator generate \
|
||||
-i /local/spec.json \
|
||||
-g jetbrains-http-client \
|
||||
-o /local
|
||||
# --additional-properties=customHeaders="X-API-Key: {{apiKey}}" \ // You need this to get past the rate limiting
|
||||
7830
apis/openaq/spec.json
Normal file
7830
apis/openaq/spec.json
Normal file
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user