Αυτοματισμός μέσω API

Το GFX Manager Elections παρέχει API endpoints για τον απομακρυσμένο έλεγχο των γραφικών.

Authentication

Όλα τα API calls απαιτούν ένα κρυπτογραφημένο κλειδί (authKey) που περιέχει το network ID σας.

GET /api/[endpoint]?authKey=[encrypted_key]

Διαθέσιμα Endpoints

Λήψη Αποτελεσμάτων

GET /api/results?authKey=[key]&type=[type]&view=[view]&id=[id]&limit=[limit]

Παράμετροι:

Παράμετρος	Απαιτείται	Τιμές	Περιγραφή
authKey	✅	Encrypted string	Κλειδί αυθεντικοποίησης
type	✅	national, european, municipal	Τύπος εκλογών
view	✅	epikrateia, p, d	Επίπεδο (Επικράτεια, ΕΠ, Δήμος)
id	Για ΕΠ/Δήμο	Number	ID περιοχής
limit	❌	Number	Μέγιστος αριθμός αποτελεσμάτων

Απόκριση:

{
  "response": "OK",
  "status": 200,
  "type": "european",
  "isDemo": false,
  "requestedResults": {
    "updated": "2026-01-27T12:00:00Z",
    "title": "ΕΠΙΚΡΑΤΕΙΑ",
    "incorporation": {
      "percentage": 75.5,
      "counted": 1500,
      "total": 2000
    },
    "participation": {
      "votes": 5000000,
      "percentage": 65.2
    },
    "invalid": {
      "votes": 50000,
      "percentage": 1.0
    },
    "blank": {
      "votes": 25000,
      "percentage": 0.5
    },
    "results": [
      {
        "party": {
          "id": 1,
          "shortName": "ΝΔ",
          "fullName": "ΝΕΑ ΔΗΜΟΚΡΑΤΙΑ",
          "color": "0066cc",
          "logo": "base64..."
        },
        "votes": 1500000,
        "percentage": 35.5,
        "seats": 150,
        "hasSeats": 1,
        "change": 2.3
      }
    ]
  }
}

Λήψη Menu Items

GET /api/menuitems?authKey=[key]

Επιστρέφει λίστα διαθέσιμων:

• Εκλογικών Περιφερειών

• Δήμων

• Κομμάτων

• Ειδών καρτών

Έλεγχος Γραφικών (Remote Control)

GET /api/remote?key=[key]&electionUpdate=[command_json]

Παράμετρος electionUpdate:

{
  "view": "epikrateia",
  "cardstyle": "percentages",
  "ep": "",
  "dimos": "",
  "party": ""
}

Τιμές view:

• epikrateia - Επικράτεια

• p - Εκλογική Περιφέρεια

• d - Δήμος

Τιμές cardstyle:

• percentages - Ποσοστά

• change - Αλλαγή

• votes - Ψήφοι

• compare - Σύγκριση

• mappercentages - Χάρτης

• candidatesvotes - Υποψήφιοι με σταυρούς

• candidatespercentages - Υποψήφιοι με ποσοστά

Λήψη Δυνατοτήτων (για Cue Manager)

GET /api/capabilities?key=[key]

Επιστρέφει δομημένη λίστα όλων των διαθέσιμων εντολών σε μορφή συμβατή με το Cue Manager.

Screenshot

GET /api/screenshot?network=[network_id]&w=[width]&h=[height]

Δημιουργεί screenshot της τρέχουσας κάρτας σε μορφή JPG.

Κατάσταση Υπηρεσίας

GET /api/status

Επιστρέφει:

• Έκδοση εφαρμογής

• Κατάσταση server

• Πληροφορίες υπηρεσίας

Socket.IO Events

Για real-time επικοινωνία, χρησιμοποιήστε Socket.IO:

Σύνδεση

const socket = io('https://elections.gfxmanager.com');
socket.emit('auth', { authKey: 'your-key' });

Αποστολή Εντολής

socket.emit('electionUpdate', {
  view: 'epikrateia',
  cardstyle: 'percentages',
  ep: '',
  dimos: '',
  party: ''
});

Αλλαγή Κατάστασης (IN/OUT)

socket.emit('electionState', {
  state: 'in' // ή 'out'
});

Λήψη Ενημερώσεων

socket.on('electionUpdate', (data) => {
  console.log('Card updated:', data);
});

socket.on('electionState', (data) => {
  console.log('State changed:', data.state);
});

Ενσωμάτωση με Cue Manager

Το Elections ενσωματώνεται αυτόματα με το Cue Manager:

1. Προσθέστε το Elections ως υπηρεσία στις ρυθμίσεις του Cue Manager

2. Οι διαθέσιμες εντολές εμφανίζονται αυτόματα

3. Δημιουργήστε λίστες με τις κάρτες που θέλετε

Διαθέσιμες Εντολές στο Cue Manager

Εντολή	Περιγραφή
Κάρτα Εκλογών	Αλλαγή δεδομένων κάρτας
IN	Εμφάνιση κάρτας
OUT	Απόκρυψη κάρτας

Παραδείγματα

Python

import requests

api_url = "https://elections.gfxmanager.com/api/results"
params = {
    "authKey": "your-encrypted-key",
    "type": "european",
    "view": "epikrateia"
}

response = requests.get(api_url, params=params)
data = response.json()

for party in data["requestedResults"]["results"]:
    print(f"{party['party']['shortName']}: {party['percentage']}%")

JavaScript

async function getResults() {
    const response = await fetch(
        'https://elections.gfxmanager.com/api/results?' +
        'authKey=your-key&type=european&view=epikrateia'
    );
    const data = await response.json();
    return data.requestedResults;
}

cURL

curl "https://elections.gfxmanager.com/api/results?authKey=KEY&type=european&view=epikrateia"

Rate Limits

Endpoint	Limit
/api/results	60 requests/minute
/api/screenshot	10 requests/minute
Socket.IO events	No limit

Κωδικοί Σφάλματος

Κωδικός	Περιγραφή
200	Επιτυχία
400	Λάθος παράμετροι
401	Μη έγκυρο authKey
403	Δεν υπάρχει άδεια
404	Δεν βρέθηκαν δεδομένα
500	Σφάλμα server