Τεκμηρίωση API

Έχουμε προγραμματίσει να αποσύρουμε το API στις 31 Οκτωβρίου 2024.
Μέχρι την ημερομηνία αυτή οι υφιστάμενοι λογαριασμοί θα συνεχίσουν να λειτουργούν κανονικά. Ωστόσο, δεν παρέχεται η δυνατότητα ενεργοποίησης νέων συνδρομών και η ανανέωση των υφιστάμενων.

Κουίζ

GET https://api.sansimera.gr/quiz

Το αίτημα μπορεί να συνοδεύεται από τις παρακάτω παραμέτρους, οι οποίες είναι όλες προαιρετικές. Ως προεπιλογή, θα επιστραφούν 10 τυχαία επιλεγμένες ερωτήσεις.

Παράμετροι Αιτήματος
Παράμετρος Περιγραφή
categories
array
Εάν επιθυμείτε να επιστραφούν ερωτήσεις από συγκεκριμένες κατηγορίες, θα πρέπει να συμπληρώσετε αυτή την παράμετρο με τα αναγνωριστικά (id) των επιθυμητών κατηγοριών. Οι διαθέσιμες κατηγορίες παρατίθενται παρακάτω.
difficulty
string
Ο βαθμός δυσκολίας των ερωτήσεων. Αποδεκτές τιμές:
easy (εύκολες)
medium (μέτριας δυσκολίας)
hard (δύσκολες)
amount
integer
Ο αριθμός ερωτήσεων που θέλετε να περιλαμβάνει η απόκριση.
Κατηγορίες
Κατηγορία ID
Αθλητισμός 13
Γενικές Γνώσεις 1
Γεωγραφία 14
Γλώσσα 23
Διασημότητες 18
Διάστημα 10
Διατροφή - Γαστρονομία 8
Επιστήμη 9
Θέατρο 5
Θρησκεία 26
Ιστορία 15
Κινηματογράφος 3
Κόμικ - Καρτούν 21
Λαογραφία 28
Λογοτεχνία 2
Μαθηματικά 11
Μνημεία - Αξιοθέατα 20
Μόδα 25
Μουσική 4
Μυθολογία 12
Οικονομία 27
Παιχνίδια 7
Πολιτική 16
Τέχνη 17
Τεχνολογία 22
Τηλεόραση 6
Φύση 19
Παράδειγμα Αιτήματος
curl -X GET https://api.sansimera.gr/quiz	
    -H "Authorization: Bearer a4GsDBSwJv74Xbcyadjca2iVkOx28zks3JRQhpWEYez8JQaqJ"
    -H "Accept: application/json"
    -H "Content-Type: application/json"
    -d '{"amount":"3"}'
	
$response = $client->request('GET', 'https://api.sansimera.gr/quiz', [
    'headers' => [
        'Accept' => 'application/json',
        'Content-Type' => 'application/json'
    ],
    'form_params' => [
        'api_token' => 'a4GsDBSwJv74Xbcyadjca2iVkOx28zks3JRQhpWEYez8JQaqJ',
        'amount' => '3'
    ]
]);
Παράδειγμα Απόκρισης
{
  "data": [
    {
      "category": "Τέχνη",
      "difficulty": "medium",
      "question": "Σε ποιον ζωγράφο ανήκει το έργο «Ιεροτελεστία της Άνοιξης»;",
      "correct_answer": "Νίκο Εγγονόπουλο",
      "incorrect_answers": [
        "Νικόλαο Γύζη",
        "Κωνσταντίνο Βολανάκη",
        "Κωνσταντίνο Παρθένη"
      ]
    },
    {
      "category": "Γεωγραφία",
      "difficulty": "medium",
      "question": "Η διώρυγα της Κορίνθου ενώνει τον Κορινθιακό Κόλπο με...",
      "correct_answer": "τον Σαρωνικό",
      "incorrect_answers": [
        "τον Αμβρακικό",
        "τον Θερμαιϊκό",
        "τον Παγασητικό"
      ]
    },
    {
      "category": "Γενικές Γνώσεις",
      "difficulty": "easy",
      "question": "Όταν ένας άνθρωπος προσλαμβάνει περισσότερη τροφή από όση χρειάζεται, τι δημιουργεί ο οργανισμός;",
      "correct_answer": "Λίπος",
      "incorrect_answers": [
        "Υδατάνθρακες",
        "Πρωτεΐνες",
        "Βιταμίνες"
      ]
    }
  ],
  "source": {
    "name": "Σαν Σήμερα .gr",
    "logo": "https://cdn.sansimera.gr/assets/img/logo/black.png",
    "url": "https://www.sansimera.gr/"
  }
}