API Documentation

Build powerful integrations with the Real Life Achievements API. Access achievements, users, and more.

Getting Started

The RLA API is a RESTful API that allows you to interact with achievements, users, challenges, and more. All requests are made to https://api.reallifeachievements.eu/v1

Base URL:

https://api.reallifeachievements.eu/v1

Authentication

The API uses JWT (JSON Web Tokens) for authentication. Include your access token in the Authorization header:

Authorization: Bearer YOUR_ACCESS_TOKEN

Obtain an access token by making a POST request to /auth/login or /auth/register.

Endpoints

Authentication

POST/auth/register

POST/auth/login

POST/auth/refresh

Refresh your access token

Achievements

GET/achievements

List all achievements (paginated)

GET/achievements/:id

Get a specific achievement by ID

POST/achievements

Create a new achievement

PUT/achievements/:id

Update an achievement

DELETE/achievements/:id

Delete an achievement

Users

GET/users/me

Get current user profile

GET/users/:username

Get user by username

PUT/users/me

Update your profile

Rate Limiting

API requests are rate-limited to ensure fair usage:

• Authenticated: 1000 requests per hour
• Unauthenticated: 100 requests per hour

Rate limit information is included in response headers: X-RateLimit-Limit and X-RateLimit-Remaining

Need Help?

For API support, integration help, or to report issues, contact us at api@reallifeachievements.eu