aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 3c2dcd0caaa4e7365b47c5fe0f66d986c46ef8a6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# Communique

Communique aims to be an activitypub platform that abstracts outboxes/inboxes away from 
handler implementations.

1) handlers are defined in a config file
2) these are read into the registry which allows lookup by name or by fqdn


# CGI

Communique uses CGI as the API between itself and your scripts. These scripts are only run **internally** and are never executed from a TCP request.

## Response API

Your CGI script MUST emit a valid CGI response.

Your CGI script reponse MUST be of content type `application/activity+json`.

Your CGI script reponse MUST be an `OrderedCollection` of ActivityStream `Object`s.

See `sample-cgi-handler.sh` for an example

## Processing

Communique will iterate through this collection of objects and add them to the outbox for the handler for that script, if they have not been posted in the last hour. **(TODO make the dedupe window configurable)**