Τεκμηρίωση API

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

Γενέθλια Διασήμων

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

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

Παράμετροι Αιτήματος
Παράμετρος Περιγραφή
date
integer
Η ημερομηνία, σε μορφή τετραψήφιου αριθμού (ddmm). Απαιτείται μόνο για την ανάκτηση των δεδομένων μιας προγενέστερης ή μεταγενέστερης ημερομηνίας.
Για παράδειγμα, για να ανακτήσετε τα δεδομένα της 1ης Φεβρουαρίου, η τιμή θα πρέπει να είναι 0102.
greece
integer
Ορίζει εάν η απόκριση θα περιλαμβάνει δεδομένα από την Ελλάδα. Αποδεκτές τιμές: 0 (όχι), 1 (ναι)
Προεπιλογή: 1
cyprus
integer
Ορίζει εάν η απόκριση θα περιλαμβάνει δεδομένα από την Κύπρο. Αποδεκτές τιμές: 0 (όχι), 1 (ναι)
Προεπιλογή: 1
world
integer
Ορίζει εάν η απόκριση θα περιλαμβάνει δεδομένα από τον υπόλοιπο κόσμο. Αποδεκτές τιμές: 0 (όχι), 1 (ναι)
Προεπιλογή: 1
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
Ο μέγιστος αριθμός εγγραφών που θέλετε να περιλαμβάνει η απόκριση.
sort
string
Ορίζει τη σειρά εμφάνισης των αποτελεσμάτων.
Αποδεκτές τιμές: asc (αύξουσα), desc (φθίνουσα)
Προεπιλογή: asc
Παράδειγμα Αιτήματος
curl -X GET https://api.sansimera.gr/birthdays	
    -H "Authorization: Bearer a4GsDBSwJv74Xbcyadjca2iVkOx28zks3JRQhpWEYez8JQaqJ"
    -H "Accept: application/json"
    -H "Content-Type: application/json"
    -d '{"image_size":"md", "amount":"3"}'
	
$response = $client->request('GET', 'https://api.sansimera.gr/birthdays', [
    'headers' => [
        'Accept' => 'application/json',
        'Content-Type' => 'application/json'
    ],
    'form_params' => [
        'api_token' => 'a4GsDBSwJv74Xbcyadjca2iVkOx28zks3JRQhpWEYez8JQaqJ',
        'image_size' => 'md',
        'amount' => '3'
    ]
]);
Παράδειγμα Απόκρισης
{
  "data": [
    {
      "first_name": "Θανάσης",
      "last_name": "Τσαλταμπάσης",
      "short_cv": "έλληνας ηθοποιός.",
      "image": "https://cdn.sansimera.gr/media/photos/main/md/Thanasis_Tsaltampasis.jpg",
      "birth_year": 1981,
      "age": 38
    },
    {
      "first_name": "Ντον",
      "last_name": "Τζόνσον",
      "short_cv": "αμερικανός ηθοποιός. ",
      "image": "https://cdn.sansimera.gr/media/photos/main/md/Don_Johnson.jpg",
      "birth_year": 1949,
      "age": 70
    },
    {
      "first_name": "Πασκάλ",
      "last_name": "Μπρικνέρ",
      "short_cv": "γάλλος συγγραφέας.",
      "image": "https://cdn.sansimera.gr/media/photos/main/md/Pascal_Bruckner.jpg",
      "birth_year": 1948,
      "age": 71
    }
  ],
  "source": {
    "name": "Σαν Σήμερα .gr",
    "logo": "https://cdn.sansimera.gr/assets/img/logo/black.png",
    "url": "https://www.sansimera.gr/"
  }
}