iPX

ipx_directory::share

Endpoint ipx_directory::share::post_snapshotSource

POST /v1/snapshot
    body   Vec<SnapshotEntry>
    ->     SnapshotResult

Share: every public feed this server’s people follow, and how many follow each.

Replaces everything this token shared before, so send the whole list each time. At most 20,000 feeds. Addresses that look private (a login, a key in the query, a paid-feed host) are refused and counted, never stored. A feed is listed once the directory has read it as one.

Access: rw

Body

Vec<SnapshotEntry>, as JSON.

Returns

SnapshotResult, as JSON.

Errors

413 Payload Too Large
More than 20,000 feeds.

Example

curl -X POST -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" -d '[{"url":"https://feeds.99percentinvisible.org/99percentinvisible","subscribers":3}]' \
  "https://directory.ipxreader.app/v1/snapshot"