εγγΙσάςς

API Reference

Explore full documentation of our public API endpoints, request patterns, and usage guidelines for expert developers.

API Endpoint Reference

Core Endpoints

GET /api/v2/users

Retrieve user information with optional filters by ID or username.

Query Params id: string, username: string

POST /api/v2/actions

Trigger system actions with required payload and authentication.

Headers Authorization: Bearer [token], Content-Type: application/json

Authentication

OAuth 2.0 Flow

  1. Request Authorization Code to your redirect URI
  2. Obtain Access Token via Client Credentials
  3. Use Bearer Token in Authorization Header

Code Example (Python)

{'import requests headers = { "Authorization": "Bearer YOUR_ACCESS_TOKEN", "Content-Type": "application/json" } response = requests.get("https://api.epsilon.com/users/12345", headers=headers) if response.status_code == 200: print(response.json()) else: print(f"Error: {response.status_code}") }'}

Rate Limiting

Hard Limit

1000 requests/minute per client

Soft Limit

900 requests/minute with warning headers

HTTP Status Mapping

Code Description
200 Successful request
401 Authentication required
429 Too many requests
503 Service temporarily unavailable