Τεκμηρίωση API

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

Ημερολόγιο

Μέσω του ημερολογίου έχετε πρόσβαση σε όλα τα δεδομένα της ημέρας: Πλήρης ημερομηνία, ημέρα του έτους, ανατολή και δύση ηλίου, εορτολόγιο και παγκόσμιες ημέρες.

Αίτημα

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

Ως προεπιλογή, η απόκριση θα περιλαμβάνει τα δεδομένα της τρέχουσας ημερομηνίας. Εφόσον η Άδεια Χρήσης (API Licence) που διαθέτετε το υποστηρίζει, μπορείτε να έχετε πρόσβαση σε οποιαδήποτε ημερομηνία, κάνοντας χρήση της παραμέτρου date.

Παράμετροι Αιτήματος
Παράμετρος Περιγραφή
date
integer
Η ημερομηνία, σε μορφή τετραψήφιου αριθμού (ddmm). Απαιτείται μόνο για την ανάκτηση των δεδομένων μιας προγενέστερης ή μεταγενέστερης ημερομηνίας.
Για παράδειγμα, για να ανακτήσετε τα δεδομένα της 7ης Δεκεμβρίου, η τιμή θα πρέπει να είναι 0712.
Παράδειγμα Αιτήματος
curl -X GET https://api.sansimera.gr/calendar	
    -H "Authorization: Bearer a4GsDBSwJv74Xbcyadjca2iVkOx28zks3JRQhpWEYez8JQaqJ"
    -H "Accept: application/json"
    -H "Content-Type: application/json"
    -d '{"date":"0712"}'
	
$response = $client->request('GET', 'https://api.sansimera.gr/calendar', [
    'headers' => [
        'Accept' => 'application/json',
        'Content-Type' => 'application/json'
    ],
    'form_params' => [
        'api_token' => 'a4GsDBSwJv74Xbcyadjca2iVkOx28zks3JRQhpWEYez8JQaqJ',
        'date' => '0712'
    ]
]);

Απόκριση

{
  "date": "Σάββατο 7 Δεκεμβρίου 2019",
  "day_of_year": "341",
  "sunrise": "07:25",
  "sunset": "17:06",
  "names": "Αθηνόδωρος, Αθηνοδώρα, Αμβρόσιος, Αμβροσία",
  "worldays": [
    {
      "title": "Διεθνής Ημέρα Πολιτικής Αεροπορίας",
      "url": "https://www.sansimera.gr/worldays/80"
    }
  ],
  "source": {
    "name": "Σαν Σήμερα .gr",
    "logo": "https://cdn.sansimera.gr/assets/img/logo/black.png",
    "url": "https://www.sansimera.gr/"
  }
}