Γενέθλια Διασήμων
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/"
}
}