How to:

  1. Register a client at https://pingu.meta1203.com/ Make sure to save the client ID and secret token, you'll need these to send messages.
  2. Add the bot to your server, if need be (link is at the bottom of this page)
  3. Register a recipient with the bot
    • To register a user, DM the bot /register to get a user id (save this), then DM the bot /client <client id> to allow your client to DM you.
    • To register a server channel, use /pingu register <clientid> to get a server ID (save this) & allow the client to message it. This is a channel-by-channel basis, so if you want the client to be able to message more than one channel, run the command in each channel you want to message.
  4. Send a message through the REST API using the client ID, the client secret token, and the recipient (user or server ID)

REST API endpoints

All endpoints are secured and require authentication. You must set the Authorization header to the client's secret key. Rest endpoint is throttled to 1 request every 200 milliseconds. (You really don't need to send 5 messages a second, let alone more than that)

Get client info:

Visit https://pingu.meta1203.com/lookup to view all users and servers associated with a client. Click on the resultant data to get the IDs you can use on the endpoint.

Send a message

https://pingu.meta1203.com/{clientId}/send/{to}
Path parameters
{clientId} - the ID of the client (required)
{to} - the ID of the recipient, either a server or a user (required)
Request parameters (?param=value&...)
message - the message to send. recommended to send this as the body, as this one has to be URL encoded.
channel - a channel of the server to send the message to. ommit to send the message to all allowed channels.
Body
a message to send. you can either use the body (recommended) or the request parameter to set a message, but at least one has to be set.
Returns a boolean value representing whether or not the message was sent.

Examples

cURL example:

curl -H "Authorization: <secret>" -X POST -d "<message>" \
	      https://pingu.meta1203.com/<clientId>/send/<recipient id>
	  

Bot invite link

https://discord.com/api/oauth2/authorize?client_id=889539839748345926&permissions=139586882560&scope=applications.commands%20bot