How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

ColorfulClouds Air Quality API

Real-time pollutant readings and AQI values under CHN and USA standards.

ColorfulClouds Air Quality API is one of 6 APIs that ColorfulClouds publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Air Quality. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and code examples.

This API exposes 1 operation across 1 path, and defines 6 schemas. It is described by OpenAPI 3.2.0, at version 2.6.

Requests are made against a single base URL, https://api.caiyunapp.com/v2.6.

1 operations 1 paths 6 schemas 1 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2.6
Base URL
https://api.caiyunapp.com/v2.6
Authentication
API Key
Resource Areas
1

Authentication & Security 1

ColorfulClouds Air Quality API declares 1 security scheme for authenticating requests. An API key is passed in the query as token (pathToken). By default, every request must be authenticated.

  • pathToken — Caiyun Weather API token. Note that the token is conventionally embedded in the path between the API version and the lng,lat segment rather than sent as a head…

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 GET. Each is listed below with its method, path, parameters, and response codes.

Air Quality 1

Real-time pollutant readings and AQI values under CHN and USA standards.

GET
/{token}/{lnglat}/air-quality
Caiyun Weather Get Realtime Air Quality
getRealtimeAirQuality 3 params → 200400401429

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are EnvelopeBase (9 properties), AirQualityRealtime (8 properties), ErrorResponse (3 properties), AQIValueDual (2 properties). Each schema is shown below with its type and property counts.

ErrorResponse
object
Error envelope returned for invalid requests, auth failures, and rate-limit violations.
3 properties 1 required
AQIDescDual
object
AQI category description under both standards.
2 properties 2 required
AQIValueDual
object
AQI numeric value under both Chinese and US standards.
2 properties 2 required
AirQualityRealtimeResponse
AirQualityRealtime
object
Realtime pollutant concentrations and AQI.
8 properties 2 required
EnvelopeBase
object
Common envelope fields returned by every Caiyun Weather endpoint.
9 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

colorfulclouds-air-quality-api-openapi.yml Raw ↑

Other APIs ColorfulClouds publishes across the network.

ColorfulClouds Alerts API
ColorfulClouds Forecast API
ColorfulClouds Precipitation Map API
ColorfulClouds Realtime API
ColorfulClouds Weather API
Where this information came from

This is an independent, third-party profile of ColorfulClouds Air Quality API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.