Home

The PGXN API

This GitHub repository contains the source code for the PGXN API. If you're interested in the details of how it works, check it out. This wiki, however, documents the REST API provided by PGXN mirrors and the PGXN API, which is itself a superset of the mirror API.

Entry Point

The entry point for all PGXN mirrors and API Servers is the index at the root of the mirror server or API URL. It maps all other APIs to URI templates. Examples:

• PGXN Master Mirror
• PGXN API Server

All clients must access this URI before any other in order to be able to construct the URIs for all other API calls. This is the only file that is guaranteed to be available at the same address at all times. It's the entry point for all API access, and the lookup table for all other API URIs. If you plan to access the PGXN API, the index API documentation is the first thing you should read after this introduction.

APIs

The following is a comprehensive list of all available APIs. Other than the index API, all are named for index key names. Follow the link to each document to learn about additional parameters and the structure of the returned content.

Mirror APIs

These APIs are offered by all mirror servers and API servers in the network. Consult the documentation for each for how the returned values may differ between mirror and API servers.

• index: Returns a JSON lookup table for all other API URIs.
• download: Download a distribution zip archive.
• readme: Returns the README file from a single release of a distribution.
• meta: Returns the META.json describing a single release of a distribution.
• dist: Returns JSON describing all releases of distribution.
• extension: Returns JSON describing all distributions and releases of an extension.
• user: Returns JSON describing a user and all distributions released by that user.
• tag: Returns JSON listing all distributions releases tagged with a specific tag.
• stats: Returns JSON with statistics on objects managed on the network.
• mirrors: Returns JSON listing all public mirrors in the network.
• spec: Returns a plain text document documenting the latest version of the PGXN Meta Spec supported by the network.

API Server APIs

These APIs are offered only by API servers.

• htmldoc: Returns an HTML snippet for a documentation file.
• search: Provides full-text search of objects on the network. Results are returned in JSON format.
• source: Provides simple access to the contents of a release of a distribution, suitable for browsing in a Web browser.
• userlist: Returns JSON listing PGXN users.