eGKK API Reference

Build integrations with our standardized API endpoints for authentication, data management, and system interaction.

API Overview

Our RESTful API uses standard HTTP methods and JSON format for all endpoints. All endpoints require API authentication. Visit the Authentication section for details.

Authentication

Bearer Token Authentication

GET /api/v1/data
Authorization: Bearer YOUR_API_KEY

Generate and manage your API keys in your user profile settings. Ensure to store and transmit API keys securely.

GET /api/v1/data

Retrieve system data by filters and parameters.

{
  "filters": {
    "search": "string",
    "sort": "asc|desc",
    "page": "int",
    "limit": "int"
  }
}

Status 200:
{
  "data": [...],
  "pagination": {
    "page": 1,
    "total_pages": 5,
    "limit": 20
  }
}

POST /api/v1/submit

Submit new data through a structured format.

{
  "type": "string",
  "data": {
    "title": "string",
    "content": "string",
    "options": { "key": "value" }
  }
}

Status 201:
{
  "id": "string",
  "created_at": "timestamp",
  "status": "success|error"
}

DELETE /api/v1/items/{id}

Remove specific items by ID from the database.

Successfully deleted item 5f3e2d8f9c9d94000388e10a

{
  "deleted_at": "2025-10-06T14:30:00Z"
}

Common Errors & Examples

Error 401: Unauthorized

{
  "error": "invalid_token",
  "message": "Provided token is invalid or expired"
}

Example Request

curl -X GET "https://egkkikikifistis.gr/api/v1/data" -H "Authorization: Bearer your_token"

Best Practices

Rate Limiting

Be mindful of our standard rate limits: 60 requests/minute for free tier, 8000/minute for pro tier.

User-Agent Header

Identify your application in the User-Agent header for better support and monitoring.

Webhooks

Set up real-time event notifications through our configurable webhook endpoints.

SDK Support

Use our official SDKs for Node.js, Python, and Go for easier implementation.