Overview
Guides for building against the Popplio API.
This section covers the mechanics of building against Popplio: how auth and permissions work, what the rate limits are, and how to report stats, handle votes, and receive webhooks. For the endpoints themselves, see the API Reference. For ready-made libraries, see the SDKs.
In this section
Authentication
API tokens for bots and servers, and scoped sessions.
Teams & Permissions
How the flat permission model works, and how to check what a user can do.
Rate Limits
How Popplio's rate limiting works and how to handle it.
Posting Bot Stats
Keeping your bot's server count and presence up to date.
Posting Server Stats
Self-reporting your server's member count instead of waiting on the automatic sync.
Votes
Checking whether someone voted, and getting told when they do.
Webhooks
Getting notified about votes and other events in real time.
Posting Changelogs
Publishing release notes to your bot's or server's page from code, such as a CI job.
Platform Stats
Public numbers about Omniplex as a whole, now and month by month.