Τεκμηρίωση API

Σαν Σήμερα (Αλμανάκ)

Ανάλογα με την Άδεια Χρήσης (API Licence) που διαθέτετε, έχετε πρόσβαση σε δεδομένα από τη βασική, την πλήρη ή/και την προσαρμοσμένη έκδοση του “Σαν Σήμερα” (Αλμανάκ), της τρέχουσας ημέρας, αλλά και οποιασδήποτε άλλης ημερομηνίας.

Αίτημα

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

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

Παράμετροι Αιτήματος

Κατηγορίες

Παράδειγμα Αιτήματος

Στο παράδειγμα που ακολουθεί, αιτούμαστε τα δεδομένα για τις 20 Μαρτίου, που αφορούν μόνο στην Ελλάδα και την Κύπρο, από την κατηγορία Αθλητισμός:

curl -X GET https://api.sansimera.gr/almanac	
    -H "Authorization: Bearer a4GsDBSwJv74Xbcyadjca2iVkOx28zks3JRQhpWEYez8JQaqJ"
    -H "Accept: application/json"
    -H "Content-Type: application/json"
    -d '{"edition":"custom", "date":"2003", "greece":"1", "cyprus":"1", "world":"0", "category":"5"}'
	

$response = $client->request('GET', 'https://api.sansimera.gr/almanac', [
    'headers' => [
        'Accept' => 'application/json',
        'Content-Type' => 'application/json'
    ],
    'form_params' => [
        'api_token' => 'a4GsDBSwJv74Xbcyadjca2iVkOx28zks3JRQhpWEYez8JQaqJ',
        'edition' => 'custom',
        'date' => '2003',
        'greece' => '1',
        'cyprus' => '1',
        'world' => '0',
        'category' => '5'
    ]
]);

Απόκριση

Στο παράδειγμα που ακολουθεί βλέπετε την απόκριση ενός αιτήματος για τη βασική έκδοση της 20ης Μαρτίου.

{
  "date": "20 Μαρτίου",
  "events": [
    {
      "year": 1800,
      "content": "Ο ιταλός φυσικός Αλεσάντρο Βόλτα ανακοινώνει με γράμμα του στον άγγλο φίλο του σερ Τζόζεφ Μπανκς ότι ανακάλυψε την μπαταρία.",
      "image": "https://cdn.sansimera.gr/media/photos/main/Alessandro_Volta.jpg"
    },
    {
      "year": 1900,
      "content": "Ο σέρβος φυσικός Νίκολα Τέσλα λαμβάνει δίπλωμα ευρεσιτεχνίας για την ασύρματη μετάδοση της ηλεκτρικής ενέργειας.",
      "image": "https://cdn.sansimera.gr/media/photos/main/Nikola_Tesla.jpg"
    },
    {
      "year": 1929,
      "content": "Ο ΠΑΟΚ συγχωνεύεται με την ΑΕΚ Θεσσαλονίκης και αλλάζει το σήμα του από τετράφυλλο πράσινο τριφύλλι στον δικέφαλο αετό.",
      "image": "https://cdn.sansimera.gr/media/photos/main/PAOK-old_logo.jpg"
    },
    {
      "year": 1947,
      "content": "Δολοφονείται στη Θεσσαλονίκη ο Γιάννης Ζέβγος, κορυφαίο στέλεχος του ΚΚΕ και του ΕΑΜ.",
      "image": "https://cdn.sansimera.gr/media/photos/main/Giannis_Zevgos.jpg"
    },
    {
      "year": 1997,
      "content": "Η πεζογράφος Γαλάτεια Σαράντη είναι η πρώτη γυναίκα που εκλέγεται τακτικό μέλος της Ακαδημίας Αθηνών.",
      "image": "https://cdn.sansimera.gr/media/photos/main/Galatia_Saranti.jpg"
    },
    {
      "year": 2004,
      "content": "Ο πρωθυπουργός, Κώστας Καραμανλής, παρουσιάζοντας στη Βουλή τις προγραμματικές δηλώσεις της κυβέρνησής του, τονίζει ότι δεν ζητά περίοδο χάριτος. Αναφέρει ότι οι βασικοί άξονες της πολιτικής του είναι ο Πολιτισμός, η Παιδεία, η επανίδρυση του κράτους και η εφαρμογή μίας νέας οικονομικής πολιτικής, στόχοι της οποίας είναι οι αυξήσεις συντάξεων και μισθών, οι ρυθμίσεις για τα πανωτόκια, οι φορολογικές ελαφρύνσεις, η αύξηση των δαπανών για την παιδεία στο 5% του ΑΕΠ, ρυθμό ανάπτυξη πάνω από 5% και μείωση της ανεργίας κατά τρεις ποσοστιαίες μονάδες στο τέλος της τετραετίας.",
      "image": "https://cdn.sansimera.gr/media/photos/main/Kostas_Karamanlis-Vouli-2004.jpg"
    }
  ],
  "births": [
    {
      "year": 1828,
      "first_name": "Ερρίκος",
      "last_name": "Ίψεν",
      "short_cv": "νορβηγός θεατρικός συγγραφέας.",
      "death_date": "23/5/1906",
      "image": "https://cdn.sansimera.gr/media/photos/main/Henrik_Ibsen.jpg"
    },
    {
      "year": 1925,
      "first_name": "Ντέιβιντ",
      "last_name": "Γουόρεν",
      "short_cv": "αυστραλός μαθηματικός και χημικός, εφευρέτης του «μαύρου κουτιού» του αεροπλάνου.",
      "death_date": "19/7/2010",
      "image": "https://cdn.sansimera.gr/media/photos/main/David_Warren.jpg"
    },
    {
      "year": 1954,
      "first_name": "Λιάνα",
      "last_name": "Κανέλλη",
      "short_cv": "ελληνίδα δημοσιογράφος και πολιτικός.",
      "death_date": null,
      "image": "https://cdn.sansimera.gr/media/photos/main/Liana_Kaneli.jpg"
    }
  ],
  "deaths": [
    {
      "year": 1727,
      "first_name": "Άιζαακ",
      "last_name": "Νιούτον",
      "short_cv": "γνωστότερος στην Ελλάδα ως Ισαάκ Νεύτων, αγγλοεβραίος φυσικός, μαθηματικός και αστρονόμος. Διατύπωσε θεωρία για τη σωματιδιακή φύση του φωτός (1669) και ανακάλυψε τον νόμο της παγκόσμιας έλξης (1687). Ανακάλυψε ακόμη τη σχέση μεταξύ χρώματος και διασποράςτου φωτός, ανέπτυξε κατοπτρικό τηλεσκόπιο και μελέτησε τους φερώνυμους δακτυλίους στην οπτική. Το κύριο σύγγραμμά του στον τομέα της δυναμικής και της αστρονομίας με τίτλο «Μαθηματικές Αρχές της Φυσικής Φιλοσοφίας» («Philosophise· Naturalis Principia Mathematica»), δημοσιεύτηκε το 1687, ενώ η «Οπτική»(«Opticks») το 1704. Στα μαθηματικά εισήγαγετο διωνυμικό θεώρημα και διατύπωσε τους κανόνες του λογισμού (1707) τον οποίο αργότερα μορφοποίησε ο Λάιμπνιτζ.",
      "birth_date": "25/12/1642",
      "image": "https://cdn.sansimera.gr/media/photos/main/Isaac_Newton.jpg"
    },
    {
      "year": 1966,
      "first_name": "Δημήτριος",
      "last_name": "Γαλάνης",
      "short_cv": "έλληνας χαράκτης, από τους πρωτοπόρους στο είδος του στον ελληνικό καλλιτεχνικό κόσμο. Ασχολήθηκε, επίσης, εκτενώς με τη γελοιογραφία και τη ζωγραφική.",
      "birth_date": "22/5/1882",
      "image": "https://cdn.sansimera.gr/media/photos/main/Dimitrios_Galanis.jpg"
    },
    {
      "year": 1997,
      "first_name": "Ανδρέας",
      "last_name": "Λεντάκης",
      "short_cv": "έλληνας πολιτικός και συγγραφέας.",
      "birth_date": "8/7/1934",
      "image": "https://cdn.sansimera.gr/media/photos/main/Andreas_Lentakis.jpg"
    }
  ],
  "source": {
    "name": "Σαν Σήμερα .gr",
    "logo": "https://cdn.sansimera.gr/assets/img/logo/black.png",
    "url": "https://www.sansimera.gr/"
  }
}