Τεκμηρίωση API

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

Αποφθέγματα

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

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

Παράμετροι Αιτήματος
Παράμετρος Περιγραφή
categories
array
Εάν επιθυμείτε να επιστραφούν αποφθέγματα από συγκεκριμένες κατηγορίες, θα πρέπει να συμπληρώσετε αυτή την παράμετρο με τα αναγνωριστικά (id) των επιθυμητών κατηγοριών. Οι διαθέσιμες κατηγορίες παρατίθενται παρακάτω.
image_size
string
Το μέγεθος των φωτογραφιών. Αν δεν καθοριστεί, οι φωτογραφίες θα είναι πλήρους μεγέθους. Αποδεκτές τιμές:
xxs (wide, 80x59 px)
xs (wide, 160x118 px)
sm (wide, 230x169 px)
md (wide, 300x220 px)
lg (wide, 350x257 px)
xl (wide, 450x330 px)
xxl (wide, 550x404 px)
xxs-square (square, 80x80 px)
xs-square (square, 160x160 px)
sm-square (square, 230x230 px)
md-square (square, 300x300 px)
lg-square (square, 350x350 px)
xl-square (square, 450x450 px)
xxl-square (square, 550x550 px)
amount
integer
Ο αριθμός αποφθεγμάτων που θέλετε να περιλαμβάνει η απόκριση.
Κατηγορίες
Κατηγορία ID
Άγιος 105
Άνδρας 163
Έγκλημα - Εγκληματίας 41
Έθιμα 44
Έθνος 69
Έπαινος 59
Έπαρση - Αυταρέσκεια 166
Έρωτας - Σεξ 63
Ήρωας 75
Ήττα 167
Όνειρα 118
Αγάπη 1
Αγνός - Αθώος 4
Αδερφός - Αδερφοσύνη 5
Αθλητισμός 153
Αισθήματα 6
Αισιοδοξία 7
Ακολασία 8
Αλήθεια 9
Αλλαγή 181
Αμαρτία - Αμαρτωλός 10
Αμιλλα - Ανταγωνισμός 106
Αμοιβή - Ανταπόδοση 12
Αμφιβολία 13
Ανάγκη 14
Αναίδεια 15
Ανθρωπος - Ανθρωπότητα 107
Απογοήτευση - Απελπισία 17
Αποτυχία 182
Αρετή 18
Αρχαιότητα 19
Αυτογνωσία 175
Βία 21
Βασιλεία - Βασιλιάς 20
Βιβλία 22
Γάμος 131
Γέλιο 136
Γαλήνη 23
Γενναιοδωρία 24
Γενναιότητα 25
Γηρατειά 26
Γλώσσα 148
Γνώμη 27
Γνώση 28
Γονείς 132
Γυναίκα 29
Δάκρυα 30
Δάσος 31
Δίκαιος - Δικαιοσύνη 34
Δειλός - Δειλία 32
Δημιουργικότητα 134
Δημοκρατία 33
Διάβολος 154
Διατροφή 160
Διεθνισμός 158
Δουλειά 37
Δυσκολίες 178
Δυστυχία 39
Δόξα 35
Δύναμη 38
Δώρα 40
Εγκράτεια 42
Εγωισμός 43
Ειλικρίνεια 45
Ειρήνη 46
Εκδίκηση 47
Εκπαίδευση 48
Εκτίμηση 49
Ελαττώματα 50
Ελεημοσύνη 146
Ελευθερία 51
Ελλάδα 143
Ελπίδα 52
Εμπιστοσύνη 53
Εμπόριο 54
Ενθουσιασμός 55
Ενότητα 56
Ενόχληση 176
Εξέλιξη 57
Εξουσία 58
Επανάσταση 60
Επιθυμία 64
Επιλογή 180
Επιστήμη 61
Επιτυχία 62
Ευγένεια 65
Ευημερία 66
Ευτυχία 67
Ευφυΐα 135
Εχθρός 68
Ζήλια - Φθόνος 71
Ζήλος 70
Ζωή 73
Ζωγραφική 72
Ζώα 162
Ηλικία 74
Θάλασσα 76
Θάνατος 77
Θέληση 79
Θαύματα 78
Θεομηνία 80
Θεός 81
Θλίψη - Λύπη 139
Θράσος 186
Θρησκεία 82
Θυμός 83
Θυσία 84
Ιατρός 85
Ιδανικά - Ιδέες 86
Ικανότητα 87
Ιστορία 89
Ισχυρογνωμοσύνη 90
Ισότητα 88
Καθήκον 91
Κακία 92
Κακολογία 93
Καλλιτεχνία 94
Καλοσύνη 95
Κατανόηση 179
Κοινωνία 97
Κολακεία 98
Κράτος 100
Κρασί 99
Κριτής - Κριτική 101
Κυβέρνηση 102
Λάθος - Σφάλμα 122
Λαός 103
Λογική - Λόγος 104
Μ.Μ.Ε 137
Μάθηση 116
Μίμηση 36
Ματαιοδοξία 119
Μετριοφροσύνη - Μέτρο 112
Μητέρα 147
Μνήμη - Ανάμνηση 16
Μοίρα 113
Μοναξιά 114
Μουσική 157
Μωρία 124
Νίκη 127
Ναρκωτικά 156
Νεότητα 140
Νόμος 142
Οικονομία 150
Ομορφιά - Κάλλος 96
Πάθη 125
Παγκοσμιοποίηση 159
Παιδεία 151
Πατριωτισμός 144
Πείρα 115
Πλούτος 165
Ποίηση 152
Πολιτική 120
Πολιτισμός 155
Πόλεμος 172
Ροκ 133
Σκέψη 171
Σκλαβιά 129
Σοσιαλισμός 161
Σοφία 123
Συμβουλή - Σύμβουλος 126
Συμφορά 110
Συμφωνία 169
Τέχνη 141
Ταλέντο 183
Ταχύτητα 2
Τελειότητα 188
Τεχνολογία 173
Τηλεόραση 174
Τιμή 130
Τρέλα 138
Τύχη 109
Υγεία 177
Υπερβολή 3
Φήμη 184
Φαντασία 185
Φιλία - Φίλος 128
Φιλοδοξία 11
Φιλοσοφία 121
Φορολογία - Φόρος 149
Φτώχεια 145
Φόβος 168
Χαρακτήρας 111
Χρήματα 108
Χρόνος 164
Ψέμα 187
Ψυχή - Ψυχολογία 117
Παράδειγμα Αιτήματος
curl -X GET https://api.sansimera.gr/quotes	
    -H "Authorization: Bearer a4GsDBSwJv74Xbcyadjca2iVkOx28zks3JRQhpWEYez8JQaqJ"
    -H "Accept: application/json"
    -H "Content-Type: application/json"
    -d '{"categories":"155,141", "image_size":"md", "amount":"3"}'
	
$response = $client->request('GET', 'https://api.sansimera.gr/quotes', [
    'headers' => [
        'Accept' => 'application/json',
        'Content-Type' => 'application/json'
    ],
    'form_params' => [
        'api_token' => 'a4GsDBSwJv74Xbcyadjca2iVkOx28zks3JRQhpWEYez8JQaqJ',
        'categories' => [155,141],
        'image_size' => 'md',
        'amount' => '3'
    ]
]);
Παράδειγμα Απόκρισης
{
  "data": [
    {
      "quote": "Ο πολιτισμός δεν ακυρώνει τη βαρβαρότητα, αλλά, πολλές φορές, την επικυρώνει. Όσο πιο πολιτισμένος είναι ένας λαός, τόσο πιο βάρβαρος και καταστροφικός μπορεί να γίνει.",
      "author": "Ουμπέρτο Έκο",
      "short_cv": "ιταλός συγγραφέας και πανεπιστημιακός.",
      "image": "https://cdn.sansimera.gr/media/photos/main/md/Umberto_Eco.jpg"
    },
    {
      "quote": "Ο διανοούμενος είναι ένας άνθρωπος που η σκέψη του βρίσκεται σ’ ανοιχτή γραμμή με το ήθος του, με την ψυχή του. Ο μορφωμένος δεν είναι πάντα εναρμονισμένος με το ήθος και την ψυχή του.",
      "author": "Νόαμ Τσόμσκι",
      "short_cv": "αμερικανός γλωσσολόγος και διανοητής.",
      "image": "https://cdn.sansimera.gr/media/photos/main/md/Noam_Chomsky.jpg"
    },
    {
      "quote": "Δύο είναι οι εχθροί της πολιτικής και του πολιτισμού: ο λαϊκισμός και ο ελιτισμός.",
      "author": "Μάνος Χατζιδάκις",
      "short_cv": "έλληνας συνθέτης.",
      "image": "https://cdn.sansimera.gr/media/photos/main/md/Manos_Xatzidakis-3.jpg"
    }
  ],
  "source": {
    "name": "Σαν Σήμερα .gr",
    "logo": "https://cdn.sansimera.gr/assets/img/logo/black.png",
    "url": "https://www.sansimera.gr/"
  }
}