Developer Centre
Reach Afriverse from your own software. A key identifies you; a webhook tells your server when something happens here.
API keys
Webhooks
No webhooks yet.
Checking a delivery is really ours
Every delivery carries a signature. Anyone can guess your address; only we can produce this. Check it before acting on what arrives.
// headers: x-afriverse-event, x-afriverse-timestamp, x-afriverse-signature
const expected = crypto
.createHmac('sha256', YOUR_WEBHOOK_SECRET)
.update(timestamp + '.' + rawBody)
.digest('hex');
if (expected !== signature) return res.status(401).end();Answer with any 2xx. A failure is retried once, two seconds later. After 25 failures in a row we switch the webhook off and tell you here, rather than hammering a server that is gone.
Using a key
Send the key as a bearer token. Two things are open so far — who you are, and your own feed. More will follow; nothing is listed here that does not already work.
curl -H "Authorization: Bearer afv_your_key" \ https://klique-api.afriverse.cc/v1/me curl -H "Authorization: Bearer afv_your_key" \ https://klique-api.afriverse.cc/v1/feed