keys.openpgp.org

About | News | Usage | FAQ | Stats | Privacy

Hagrid implements both the legacy HKP interface, as well as our native interface, VKS.

Verifying Keyserver (VKS) Interface

Hagrid has its own URL scheme to fetch, submit, and verify keys.

Error handling

If a GET request fails for any reason, a suitable HTTP status code will be returned. The response will be a plaintext error message. If a key is not found, the HTTP status code will be 404.

If a POST request fails for any reason, a suitable HTTP status code will be returned. The response body will be a JSON object with a single error attribute. A POST request may fail with a HTTP 503 error at any time if the server is undergoing database maintenance. Clients should handle errors gracefully for POST requests.

Example response:
{
  "error": "We are currently undergoing scheduled database maintenance!"
}
      

Rate Limiting

Requests to the keys.openpgp.org API are rate limited:

HTTP Keyserver Protocol (HKP) Interface

Hagrid implements a subset of the HKP protocol so that tools like GnuPG and OpenKeychain can use it without modification.

Rate limiting applies as for the VKS interface above.

Limitations

By design, Hagrid does not implement the full HKP protocol. The specific limitations are:

Hagrid v0.1.0 built from 6b311df

Powered by Sequoia-PGP

Background image retrieved from Subtle Patterns under CC BY-SA 3.0