Skip to content

api headers

Jump to bottom Edit New page
David E. Wheeler edited this page Mar 23, 2017 · 2 revisions

HTTP Headers

PGXN API servers provide a special HTTP header not provided by mirror servers. The header is X-PGXN-API-Version and identifies the semantic version of the release of PGXN::API that's serving the API:

> curl -I https://api.pgxn.org/index.json
HTTP/1.1 200 OK
Date: Wed, 27 Apr 2011 00:00:39 GMT
Content-Type: application/json
Content-Length: 576
Last-Modified: Mon, 25 Apr 2011 18:15:31 GMT
X-PGXN-API-Version: v0.12.5

Use this header to distinguish API servers from mirror servers. In the future it may be used to ascertain what API features are available, although it should not be necessary, since all APIs are identified by the index API.

Other Resources

If you have any questions about the PGXN Mirror and API Server APIs, please post them to the PGXN Users list. If you find any bugs in the API, please report them. To follow news about PGXN, subscribe to the blog and the Mastodon stream.

Quick Links

Basics

Mirror APIs

API Server APIs

Clone this wiki locally