Skip to main content

API Overview

PingPanda provides a simple REST API for sending events.

Base URL​

https://pingpanda.com/api/v1

Authentication​

All API requests require authentication using your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Rate Limits​

  • Free Plan: 60 requests per minute
  • Pro Plan: 200 requests per minute

Rate limit information is returned in response headers:

  • X-RateLimit-Limit: Maximum requests allowed
  • X-RateLimit-Remaining: Remaining requests in the window
  • X-RateLimit-Reset: Unix timestamp when the limit resets
  • Retry-After: Seconds to wait before retrying (when rate limited)

Response Format​

All responses are JSON. Successful responses return 200 OK. Errors return appropriate HTTP status codes with error messages.

Endpoints​

Error Codes​

  • 400 - Bad Request (invalid JSON, missing fields)
  • 401 - Unauthorized (invalid or missing API key)
  • 403 - Forbidden (Discord ID not set)
  • 404 - Not Found (category doesn't exist)
  • 422 - Unprocessable Entity (validation error)
  • 429 - Too Many Requests (rate limit exceeded)
  • 500 - Internal Server Error