Μετατροπή ελληνικών ονομάτων σε κλητική — για email, SMS και αυτοματισμούς
Φτιαγμένο από τον Δημήτρη Χατζημιχαηλίδη επειδή κουράστηκε να γράφει «Αγαπητέ Γιώργη» στο χέρι
Το API δέχεται ένα ελληνικό μικρό όνομα (ή greeklish) και επιστρέφει την κλητική του. Π.χ. Γιώργης → Γιώργη, Kostas → Κώστα.
Πάντα επιστρέφει αποτέλεσμα — ποτέ δεν αποτυγχάνει για έγκυρο input.
Όλα τα requests χρειάζονται header:
X-API-Key: your_api_key
Επιστρέφει την κλητική ενός ονόματος.
"first_name": "Γιώργης Παπαδόπουλος"
Μπορείς να στείλεις μόνο το όνομα ή ολόκληρο το πλήρες όνομα (όνομα + επώνυμο) χωρισμένα με κενό.
{
"input": "Γιώργης",
"nominative": "Γιώργης",
"vocative": "Γιώργη",
"vocative_lower": "γιώργη",
"vocative_upper": "ΓΙΩΡΓΗ",
"confidence": "curated",
"source": "lookup",
"gender": "M",
"full_name": "Γιώργης Παπαδόπουλος",
"last_name": "Παπαδόπουλος"
}
Επιστρέφει κλητικές για πολλά ονόματα μαζί (έως 500).
{
"names": ["Γιώργης", "Μαρία", "Kostas"]
}
{
"results": [ // ένα αντικείμενο ανά όνομα, ίδια μορφή με /onoma ],
"total": 3,
"ai_calls": 0
}
Έλεγχος κατάστασης — δεν χρειάζεται authentication.
| Πεδίο | Παράδειγμα | Χρήση |
|---|---|---|
vocative | Γιώργη | Email — κεφαλαίο πρώτο γράμμα, με τόνους |
vocative_upper | ΓΙΩΡΓΗ | SMS — όλα κεφαλαία, χωρίς τόνους |
vocative_lower | γιώργη | Αν χρειαστείς πεζά (σπάνια) |
full_name | Γιώργης Παπαδόπουλος | Ονομαστική + επώνυμο έτοιμα για χρήση (αν δόθηκε μόνο όνομα, ισούται με nominative) |
nominative | Γιώργης | Ονομαστική όπως αναγνωρίστηκε (πάντα μόνο το όνομα) |
last_name | Παπαδόπουλος | Επώνυμο όπως δόθηκε — υπάρχει μόνο αν στάλθηκε πλήρες όνομα |
confidence | curated | Αξιοπιστία αποτελέσματος (δες παρακάτω) |
gender | M | M ή F |
source | lookup | Πώς βρέθηκε (lookup, rule, ai_pending κλπ) |
| Τιμή | Σημαίνει | Χρήση |
|---|---|---|
| curated | Εγκεκριμένο από άνθρωπο | Χρησιμοποίησέ το κατευθείαν |
| rule_high | Βγήκε από γραμματικό κανόνα υψηλής βεβαιότητας | Ασφαλές |
| rule_low | Γραμματικός κανόνας χαμηλότερης βεβαιότητας | Συνήθως σωστό |
| pending_approval | AI πρόταση, περιμένει ανθρώπινη έγκριση | Χρησιμοποιήσιμο, μπορεί να διορθωθεί |
| unchanged | Δεν αναγνωρίστηκε, επιστρέφεται το input ως έχει | Δείξε fallback στον χρήστη |
curl -X POST https://your-domain/onoma \ -H "X-API-Key: your_api_key" \ -H "Content-Type: application/json" \ -d '{"first_name": "Γιώργης"}'
Υπάρχει έτοιμο Make.com module που μπορείς να κάνεις copy-paste απευθείας στο σενάριό σου — χωρίς να ρυθμίσεις τίποτα από μηδέν.
⬇ Κατέβασε Make.com ModuleΟδηγίες χρήσης:
{{api_key}} με το κλειδί σου και {{first_name}} με το πεδίο ονόματος| Πεδίο | Τιμή |
|---|---|
| Method | POST |
| URL | https://posmelene.dicha.me/onoma |
| Header | Authorization: Bearer {{api_key}} |
| Body (JSON) | {"first_name": "{{first_name}}"} |
Από το response χρησιμοποίησε {{vocative}} για email (π.χ. Αγαπητέ Γιώργη) ή {{vocative_upper}} για SMS (π.χ. ΑΓΑΠΗΤΕ ΓΙΩΡΓΗ).
Το API αναγνωρίζει και greeklish: Kostas → Κώστα, Maria → Μαρία.
vocative συμπληρωμένο.
Κατέβασε έτοιμο Postman collection με τα endpoints Single Name και Batch — το api_url είναι προσυμπληρωμένο με https://posmelene.dicha.me. Μόνο το api_key χρειάζεται να συμπληρωθεί.