Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

NGINX HTTP Caches API

The HTTP Caches API from NGINX — 2 operation(s) for http caches.

NGINX HTTP Caches API is one of 32 APIs that NGINX publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include HTTP Caches. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a JSON-LD context, a getting-started guide, and a GitHub repository.

This API exposes 3 operations across 2 paths, and defines 3 schemas. It is described by OpenAPI 3.0.3, at version 0.8.

3 operations 2 paths 3 schemas 1 DELETE2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
0.8
Contact
Resource Areas
1

Paths & Operations 3

Across 2 paths, the API surfaces 3 operations — 1 DELETE, 2 GET. Each is listed below with its method, path, parameters, and response codes.

HTTP Caches 3
GET
/http/caches/
NGINX Return Status of All Caches
getHttpCaches 1 param → 200404
GET
/http/caches/{httpCacheZoneName}
NGINX Return Status of a Cache
getHttpCacheZone 2 params → 200404
DELETE
/http/caches/{httpCacheZoneName}
NGINX Reset Cache Statistics
deleteHttpCacheZoneStat 1 param → 204404405

Schemas 3

The contract defines 3 schemas that model the data the API accepts and returns. The most detailed are NginxHTTPCache (10 properties), NginxError (3 properties). Each schema is shown below with its type and property counts.

NginxHTTPCache
object
10 properties
NginxError
object
nginx error object.
3 properties
NginxHTTPCachesMap
object
Status information of all HTTP caches configured by proxycachepath and other “ cachepath ” directives.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

nginx-http-caches-api-openapi.yml Raw ↑

Other APIs NGINX publishes across the network.

NGINX Ingress Controller
NGINX Gateway Fabric
NGINX Agent
NGINX Connections API
NGINX General Info API
NGINX HTTP API
NGINX HTTP Keyvals API
NGINX HTTP Limit Conns API
NGINX HTTP Limit Reqs API
NGINX HTTP Location Zones API
NGINX HTTP Requests API