Documentation

Configuration

In order to use Aperture, or any Microsub app, you'll need to sign in using IndieAuth.

If you're running WordPress, you can install the WordPress IndieAuth plugin to quickly add support for IndieAuth to your website. Otherwise, you can check if your CMS supports IndieAuth, or connect your site to an existing IndieAuth service or write your own.

Set up using IndieAuth.com

If your website doesn't already support IndieAuth, the quickest way to get started is to use the hosted indieauth.com service.

Add the two HTML tags below to your home page in the <head> section:

<link rel="authorization_endpoint" href="https://indieauth.com/auth">
<link rel="token_endpoint" href="https://tokens.indieauth.com/token">

Next, add a link from your home page to your GitHub profile or email address (or both) like the below:

<a rel="me" href="https://github.com/username">
<a rel="me" href="mailto:you@example.com">

Now you'll be able to sign in to Aperture, or any other IndieAuth app!



API Keys

Adding an API key to a channel will let you use that API key to write posts directly into the channel rather than following an external feed. This is useful if you're writing your own custom integrations, such as adding an entry to a channel every time you receive a Webmention.

Once you have an API key, you can use it like a Micropub access token. Aperture's API accepts Micropub requests to create content in channels.

POST https://aperture.p3k.io/micropub
Authorization: Bearer (CHANNEL API KEY)
Content-type: application/x-www-form-urlencoded

h=entry&content=Hello+World

See indieweb.org/Micropub for more details on how to make a Micropub request.



Microsub Client Development

To test API calls, you can generate a token from your token endpoint yourself or by using this access token tool.

Aperture has implemented the following actions in the Microsub spec: