ΣΥΧΝΕΣ ΕΡΩΤΗΣΕΙΣ

Τι συμβαίνει αν ένα όνομα μπορεί να είναι τόσο ανδρικό όσο και γυναικείο;

Ανάλογα με την έκδοση του API ή την ενσωμάτωση που χρησιμοποιείς, τα endpoints μας είτε θα επιστρέφουν μια τιμή accuracy είτε probability στην απάντηση. Η παράμετρος accuracy επιστρέφει πόσο σίγουροι είμαστε ότι αυτό το όνομα είναι είτε αντρικό είτε γυναικείο. Η τιμή υπολογίζεται από τον αριθμό των εγγραφών στη βάση δεδομένων μας. Για παράδειγμα, αν έχουμε 100 δείγματα ενός ονόματος, τα 96 είναι γυναικεία και τα 4 αντρικά, η accuracy είναι 96% (ή πιθανότητα .96). Μια χαμηλή τιμή accuracy δείχνει ότι αυτό το όνομα πιθανώς χρησιμοποιείται από πολλαπλά φύλα και δεν μπορεί να αποδοθεί σε συγκεκριμένο φύλο.

Μπορεί να υπάρχουν διαφορές για το ίδιο όνομα ανά χώρα;

Ενώ το όνομα Andrea είναι ανδρικό στην Ιταλία, το Andrea είναι γυναικείο όνομα στη Γερμανία και μπορεί να είναι και τα δύο στις ΗΠΑ. Σε αυτήν την περίπτωση, παρέχουμε μια τιμή ακρίβειας στο αποτέλεσμα του ερωτήματος, που κυμαίνεται μεταξύ 0 και 100 (ή μια τιμή πιθανότητας μεταξύ 0 και 1). Σου λέει πόσο σίγουροι είμαστε ότι έχουμε ανιχνεύσει το σωστό φύλο. Μπορείς να αυξήσεις σημαντικά την ποιότητα των αποτελεσμάτων της API παρέχοντας κάποιες γεωγραφικές πληροφορίες για το ερώτημά σου. Αυτό μπορεί να είναι είτε ένας κωδικός χώρας, η τοπική ρύθμιση του προγράμματος περιήγησης ή μια διεύθυνση IP. Μπορείς να μάθεις περισσότερα για την τοπικοποίηση ενός ερωτήματος στα API docs

Πώς συλλέγετε τα δεδομένα;

Για να παρέχουμε την υψηλότερη δυνατή ακρίβεια, συνδυάζουμε δεδομένα από πολλαπλές πηγές. Οι κύριες πηγές για νέες εγγραφές είναι τα δημόσια διαθέσιμα δεδομένα, δεδομένα από κυβερνητικές πηγές και χειροκίνητες προσθήκες/διορθώσεις. Βάσει της πηγής ενός νέου ονόματος, το όνομα μπορεί να χρειαστεί να επαληθευτεί από μια δεύτερη πηγή πριν προστεθεί στη λίστα μας. Για παράδειγμα, αν προσθέσουμε ένα όνομα από δημόσια διαθέσιμα δεδομένα, αυτό το όνομα μπορεί να χρειαστεί δεύτερη επαλήθευση, όπως χειροκίνητη επιβεβαίωση, πριν τελικά προστεθεί στη βάση δεδομένων μας. Μπορείς να βρεις μια λίστα από υποστηριζόμενες χώρες here.

Κάθε πότε ενημερώνετε τα αρχεία ονομάτων;

Ενημερώνουμε τακτικά τα δεδομένα μας ανάλογα με τη χώρα και τα διαθέσιμα δημόσια δεδομένα.Οι περισσότερες δυτικές χώρες ενημερώνονται μία φορά το χρόνο. Επίσης, η κατανομή των ονομάτων στα φύλα μπορεί να αλλάξει με τα χρόνια. Για παράδειγμα, αν ένα όνομα χρησιμοποιούταν αποκλειστικά από γυναίκες τη δεκαετία του 1970, μπορεί να χρησιμοποιείται κυρίως από άνδρες δεκαετίες αργότερα.Γι' αυτό χρησιμοποιούμε και δεδομένα γέννησης για πολλές χώρες, όπως οι ΗΠΑ, για να εμπλουτίσουμε τα αποτελέσματα. Τα μοντέλα μας προσπαθούν να λάβουν υπόψη όλους αυτούς τους παράγοντες όσο καλύτερα γίνεται.Η επιστρεφόμενη τιμή ακρίβειας προσαρμόζεται τακτικά για να αντικατοπτρίζει την πραγματική χρήση στον πληθυσμό όσο το δυνατόν πιο ακριβή. Η τιμή υποτίθεται ότι παρέχει μια λογική αξιολόγηση βασισμένη στις τελευταίες δεκαετίες και μπορεί να εκφράζει μια πιθανή διακύμανση. Κοιτάζουμε περίπου τις τελευταίες 4 δεκαετίες των δεδομένων. Αν κάνεις ένα ερώτημα και επαναλάβεις το ίδιο ερώτημα ένα χρόνο αργότερα, μπορεί να λάβεις διαφορετικό αποτέλεσμα επειδή το σύστημά μας μπορεί να έχει απορρίψει παλιά δεδομένα και να έχουν προστεθεί νέα δεδομένα. Κάθε φορά που προστίθενται νέα δεδομένα, εκτελούμε τα λεγόμενα τεστ ενσωμάτωσης αργότερα.Σε αυτήν τη διαδικασία, η [API] μας δοκιμάζεται έναντι ενός προηγουμένως επικυρωμένου συνόλου δεδομένων για να εξασφαλιστεί η ποιότητα.Αυτό το σύνολο δεδομένων επεκτείνεται συνεχώς με ονόματα και περιπτώσεις δοκιμών για να επιτευχθεί η ευρύτερη δυνατή κάλυψη.

Πώς διευκολύνετε την Τεχνητή Νοημοσύνη;

Η τεχνητή νοημοσύνη (AI) χρησιμοποιείται για να βελτιώσει την ποιότητα της βάσης δεδομένων μας και των αποτελεσμάτων του API καθημερινά. Με τη βοήθεια της τεχνητής νοημοσύνης, μπορούμε να προσθέτουμε νέες εγγραφές στη βάση δεδομένων μας με αποτελεσματικό και ακριβή τρόπο, διασφαλίζοντας ότι οι πληροφορίες μας είναι πάντα ενημερωμένες. Επιπλέον, η τεχνητή νοημοσύνη παίζει επίσης κρίσιμο ρόλο στη βελτίωση της συνολικής ποιότητας των αποτελεσμάτων του API. Εκμεταλλευόμενοι τους αλγορίθμους μηχανικής μάθησης, μπορούμε να αναλύουμε τα δεδομένα πιο αποτελεσματικά, να εντοπίζουμε πρότυπα και να παρέχουμε πιο ακριβή και σχετική αποτελέσματα στους χρήστες μας.

Παρέχετε κάποια βοήθεια για την υλοποίηση του [API];

Ναι, παρέχουμε υποστήριξη μέσω email για όλους τους πελάτες. Μπορείς να μας στείλεις email στο contact gender-api.com. Θα επικοινωνήσουμε μαζί σου το συντομότερο δυνατόν. Μπορείς επίσης να βρεις παραδείγματα κώδικα εδώ. Λάβετε υπόψη ότι δεν μπορούμε να σε βοηθήσουμε με κάθε γλώσσα προγραμματισμού και περίπτωση χρήσης. Στις περισσότερες περιπτώσεις, μπορείς να χρησιμοποιήσεις έναν τυπικό rest client στην εφαρμογή σου για να κάνεις ερώτημα στην API μας. Πολλές βιβλιοθήκες υποστηρίζουν επίσης την εισαγωγή ενός αρχείου ορισμού OpenAPI. Μπορείς να κατεβάσεις το αρχείο ορισμού openapi.yml εδώ.

Τι γίνεται αν χρειάζομαι υψηλό επίπεδο ακρίβειας;

Οι γλώσσες και τα ονόματα είναι ρευστά και αλλάζουν με την πάροδο του χρόνου. Από πελάτη σε πελάτη, τα σύνολα δεδομένων ποικίλλουν επίσης πολύ στην ποιότητα, το εύρος και την προέλευση. Επομένως, δεν μπορούμε να εγγυηθούμε ότι όλα τα αποτελέσματα που λαμβάνετε από το API μας είναι 100% σωστά και ταιριάζουν με τη δική σας βάση δεδομένων. Αλλά μπορούμε να υποσχεθούμε ότι είμαστε πάντα αφοσιωμένοι στο να σας παρέχουμε τα καλύτερα δυνατά αποτελέσματα και ότι βελτιώνουμε και ενημερώνουμε τακτικά τους αλγορίθμους μας. Προσθέτουμε επίσης νέα δεδομένα σε πολύ τακτική βάση. Μπορείτε να μάθετε περισσότερα για τις ενημερώσεις μας εδώ. Σε περίπτωση που η υπηρεσία μας δεν ανταποκριθεί στις προσδοκίες σου, σου προσφέρουμε μια απλή εγγύηση επιστροφής χρημάτων 14 ημερών. Φυσικά, προσφέρουμε επίσης τη δυνατότητα να δοκιμάσεις την υπηρεσία μας εντελώς δωρεάν. Αν εγγραφείς εδώ, θα λάβεις 100 αιτήματα δωρεάν κάθε μήνα. Αν κάνεις ερώτημα για ένα όνομα, τα σημεία τερματισμού μας θα επιστρέψουν είτε μια τιμή ακρίβειας είτε μια τιμή πιθανότητας στην απάντηση, ανάλογα με την έκδοση API σου. Η παράμετρος ακρίβειας επιστρέφει πόσο σίγουροι είμαστε ότι αυτό το όνομα είναι ανδρικό ή γυναικείο. Η τιμή υπολογίζεται από τον αριθμό των εγγραφών για αυτό στη βάση δεδομένων μας. Δεδομένου ότι οι περιπτώσεις χρήσης διαφέρουν σημαντικά, δεν δίνουμε συστάσεις σχετικά με το επίπεδο ακρίβειας. Ανάλογα με την περίπτωση χρήσης σου, εναπόκειται σε εσένα να αποφασίσεις ποια αποτελέσματα και επίπεδα ακρίβειας θα αποδεχτείς. Ακόμα και με ακρίβεια τουλάχιστον 99%, υπάρχει πιθανότητα το αποτέλεσμα να είναι εσφαλμένο. Ωστόσο, μια τιμή πάνω από 95% ταιριάζει γενικά στις περισσότερες περιπτώσεις χρήσης

Πόσα ονόματα έχετε αποθηκεύσει στη βάση δεδομένων σας;

Η βάση δεδομένων μας περιέχει 6,084,389 επικυρωμένα ονόματα από 191 διαφορετικές χώρες. Σε όλο τον κόσμο αποθηκεύουμε 6,393,872 μοναδικά ονόματα. Κατά μέσο όρο αναλύουμε περίπου 10,000,000 σύνολα δεδομένων το μήνα για να βελτιώσουμε την ποιότητα των αποτελεσμάτων μας.

Ποιες χώρες υποστηρίζονται;

Η API υποστηρίζει πλήρως 191 χώρες. Πλήρης υποστήριξη σημαίνει ότι συλλέξαμε τουλάχιστον ονόματα σε αυτήν την αντίστοιχη χώρα. Ωστόσο, στις περισσότερες χώρες το σύνολο δεδομένων μας είναι πολύ μεγαλύτερο. Ρίξε μια ματιά στον παρακάτω πίνακα για να μάθεις περισσότερα για το πόσα ονόματα υποστηρίζουμε σε κάθε χώρα. Λάβε υπόψη ότι αν δεν παρέχουμε κατάλληλη υποστήριξη για μια χώρα, μπορείς ακόμα να ελέγξεις τα ζητούμενα ονόματα σε όλο το σύνολο δεδομένων για να λάβεις ένα επαρκές αποτέλεσμα.
1.
Andorra
1,342
2.
United Arab Emirates
24,000
3.
Afghanistan
3,657
4.
Albania
9,928
5.
Armenia
2,560
6.
Angola
17,608
7.
Argentina
18,725
8.
Austria
18,058
9.
Australia
16,329
10.
Azerbaijan
7,973
11.
Bosnia and Herzegovina
6,282
12.
Barbados
689
13.
Bangladesh
18,448
14.
Belgium
48,156
15.
Burkina Faso
5,373
16.
Bulgaria
7,938
17.
Bahrain
7,563
18.
Burundi
1,316
19.
Benin
8,416
20.
Brunei
1,201
21.
Bolivia
2,965
22.
Brazil
93,465
23.
Bahamas
971
24.
Botswana
3,981
25.
Belarus
5,455
26.
Belize
585
27.
Canada
26,187
28.
Congo - Kinshasa
2,119
29.
Congo - Brazzaville
7,835
30.
Switzerland
37,788
31.
Côte d’Ivoire
29,601
32.
Chile
11,353
33.
Cameroon
17,532
34.
China
46,378
35.
Colombia
25,550
36.
Costa Rica
4,055
37.
Cuba
2,354
38.
Cape Verde
3,251
39.
Cyprus
6,631
40.
Czech Republic
28,020
41.
Germany
92,526
42.
Djibouti
2,956
43.
Denmark
12,322
44.
Dominican Republic
7,348
45.
Algeria
41,590
46.
Ecuador
8,125
47.
Estonia
3,570
48.
Egypt
26,773
49.
Western Sahara
403
50.
Spain
300,734
51.
Ethiopia
5,964
52.
Finland
8,663
53.
Fiji
1,564
54.
Micronesia
396
55.
France
208,218
56.
Gabon
5,275
57.
United Kingdom
105,368
58.
Georgia
2,670
59.
French Guiana
1,498
60.
Ghana
16,393
61.
Gibraltar
685
62.
Greenland
337
63.
Gambia
1,724
64.
Guinea
1,982
65.
Guadeloupe
1,193
66.
Equatorial Guinea
1,528
67.
Greece
21,689
68.
Guatemala
3,993
69.
Guam
533
70.
Guyana
672
71.
Hong Kong SAR China
11,574
72.
Honduras
2,759
73.
Croatia
5,376
74.
Haiti
1,630
75.
Hungary
20,347
76.
Indonesia
107,059
77.
Ireland
11,509
78.
Israel
14,677
79.
India
149,630
80.
Iraq
15,966
81.
Iran
15,702
82.
Iceland
2,822
83.
Italy
118,384
84.
Jersey
721
85.
Jamaica
2,866
86.
Jordan
9,461
87.
Japan
39,530
88.
Kenya
16,962
89.
Kyrgyzstan
2,623
90.
Cambodia
3,704
91.
Comoros
974
92.
South Korea
51,070
93.
Kuwait
18,370
94.
Kazakhstan
7,126
95.
Laos
1,622
96.
Lebanon
14,202
97.
Saint Lucia
593
98.
Liechtenstein
366
99.
Sri Lanka
11,671
100.
Liberia
1,252
101.
Lesotho
1,135
102.
Lithuania
4,217
103.
Luxembourg
4,734
104.
Latvia
3,309
105.
Libya
4,513
106.
Morocco
52,767
107.
Monaco
955
108.
Moldova
3,511
109.
Montenegro
1,751
110.
Madagascar
5,853
111.
Macedonia
5,892
112.
Mali
5,697
113.
Myanmar [Burma]
7,184
114.
Mongolia
1,389
115.
Martinique
1,023
116.
Mauritania
1,892
117.
Malta
3,718
118.
Mauritius
7,320
119.
Maldives
1,811
120.
Malawi
1,961
121.
Mexico
33,427
122.
Malaysia
46,913
123.
Mozambique
9,859
124.
Namibia
4,092
125.
New Caledonia
613
126.
Niger
2,466
127.
Nigeria
101,869
128.
Nicaragua
2,459
129.
Netherlands
57,468
130.
Norway
13,165
131.
Nepal
5,793
132.
New Zealand
6,060
133.
Oman
12,514
134.
Panama
3,382
135.
Peru
15,609
136.
French Polynesia
730
137.
Papua New Guinea
1,401
138.
Philippines
37,394
139.
Pakistan
22,909
140.
Poland
25,763
141.
Puerto Rico
4,527
142.
Palestinian Territories
3,968
143.
Portugal
44,374
144.
Paraguay
2,478
145.
Qatar
10,433
146.
Réunion
6,210
147.
Romania
32,764
148.
Serbia
11,751
149.
Russia
49,964
150.
Rwanda
3,757
151.
Saudi Arabia
70,408
152.
Seychelles
1,006
153.
Sudan
7,360
154.
Sweden
29,095
155.
Singapore
19,257
156.
Saint Helena
2,469
157.
Slovenia
5,277
158.
Slovakia
9,364
159.
Sierra Leone
1,246
160.
San Marino
492
161.
Senegal
17,514
162.
Somalia
1,276
163.
Suriname
688
164.
São Tomé and Príncipe
486
165.
El Salvador
5,072
166.
Syria
6,672
167.
Swaziland
879
168.
Chad
829
169.
Togo
6,000
170.
Thailand
93,345
171.
Tajikistan
1,243
172.
Timor-Leste
488
173.
Turkmenistan
1,002
174.
Tunisia
23,123
175.
Turkey
112,624
176.
Trinidad and Tobago
2,003
177.
Taiwan
35,140
178.
Tanzania
8,548
179.
Ukraine
18,808
180.
Uganda
10,927
181.
United States
169,208
182.
Uruguay
2,862
183.
Uzbekistan
3,332
184.
Venezuela
17,889
185.
U.S. Virgin Islands
449
186.
Vietnam
30,496
187.
Yemen
6,352
188.
Mayotte
543
189.
South Africa
50,459
190.
Zambia
3,796
191.
Zimbabwe
4,627

Υποστηρίζετε αραβικά ονόματα;

Ναι, το API μας υποστηρίζει αραβικά ονόματα. Μπορούν επίσης να γραφούν με χαρακτήρες από το αραβικό αλφάβητο. Το αραβικό γράφεται από δεξιά προς τα αριστερά σε καλλιγραφικό στιλ και περιλαμβάνει 28 γράμματα. Για παράδειγμα, αν κάνετε ερώτημα για "عبد ال" θα λάβετε το εξής αποτέλεσμα: "gender": "male", "accuracy": 100. Το αραβικό όνομα "عبد ال" είναι κωδικοποιημένο σε url σε αυτό το παράδειγμα και η διεύθυνση ερωτήματος θα μοιάζει έτσι: https://gender-api.com/get?name=%D8%B9%D8%A8%D8%AF%20%D8%A7%D9%84&key=YOUR_API_KEY. Μπορείτε να βρείτε μια πλήρη λίστα από υποστηριζόμενες χώρες εδώ

Άκουσα για το EMAIL API σας. Τι ακριβώς είναι;

Η υπηρεσία email API μπορεί να εξάγει ονόματα από διευθύνσεις email και να παρέχει το κατάλληλο φύλο σε αυτή τη διεύθυνση. Αυτό μπορεί να βοηθήσει να εξατομικεύσεις τα email σου με μια σωστή προσφώνηση. Για παράδειγμα, από τη διεύθυνση email "[marie.johnson@gmail.com]", το API θα εξάγει το όνομα "Marie" και θα καθορίσει το σωστό φύλο, που είναι "θηλυκό". Για λεπτομέρειες παρακαλούμε ρίξε μια ματιά στα API Docs μας.

Έχω τεράστιο όγκο δεδομένων. Μπορώ να ανεβάσω μαζικά ένα αρχείο CSV;

Ως εγγεγραμμένος χρήστης μπορείς να ανεβάσεις οποιοδήποτε αρχείο CSV που περιέχει στήλη με ονόματα. Για καλύτερο αποτέλεσμα προσδιορισμού, μπορείς προαιρετικά να προσθέσεις μια στήλη χώρας στο σύνολο δεδομένων σου. Αν και δεν είναι απαραίτητο να ονομάσεις συγκεκριμένα τις στήλες, ο βοηθός μας σε καθοδηγεί στη διαδικασία επιτρέποντάς σου να επιλέξεις ποια στήλη περιέχει ποιον δείκτη, συμπεριλαμβανομένου του ονόματος ή της χώρας. Η λειτουργία βρίσκεται μέσα στο σύνοι σου λογαριασμός. Οι επεξεργασμένες εγγραφές θα χρεώνονται όπως τα αιτήματα, ώστε να μπορείς να ανεβάσεις ένα αρχείο CSV με έως και 100 εγγραφές δωρεάν κάθε μήνα. Το μαζικό ανέβασμα CSV απαιτεί λογαριασμό Gender-API.com. Για λόγους προστασίας δεδομένων, τα ανεβασμένα αρχεία θα διαγράφονται αυτόματα μετά από ένα έτος.

Πώς πρέπει να είναι μορφοποιημένο το αρχείο CSV;

Υποστηρίζουμε αρχεία CSV που έχουν δημιουργηθεί σε Windows, MacOS ή Linux. Επιπλέον, υποστηρίζουμε αρχεία με διαχωριστικά όπως ";" "," ή ένα tab. Ο χαρακτήρας περίφραξης πρέπει να είναι ". Επιπλέον, μπορείτε να ανεβάσετε πολυγραμμικά αρχεία CSV με μέγιστο 10.000.000 γραμμές και 301MB. Συστήνουμε να χρησιμοποιήσετε ένα αρχείο CSV σε μορφή UTF-8 με ερωτηματικό ως διαχωριστικό για να επιτύχετε τα καλύτερα δυνατά αποτελέσματα. Διαφορετικά, το αρχείο CSV μπορεί να περιέχει επιπλέον, αυθαίρετες γραμμές, οι οποίες θα περιλαμβάνονται επίσης στο αρχείο εξόδου. Το αρχείο πρέπει να έχει τουλάχιστον μία στήλη με μόνο πρώτα ονόματα ή μία στήλη με πλήρη ονόματα. Κάνε κλικ εδώ για να κατεβάσεις ένα δείγμα αρχείου. Παρακαλώ δημιούργησε έναν λογαριασμό στο Gender-API.com για να ανεβάσεις ένα αρχείο CSV.

Μπορώ να ανεβάσω ένα αρχείο EXCEL;

Μπορείς να ανεβάσεις αρχεία Excel με έως και 300.000 γραμμές. Για μεγαλύτερα σύνολα δεδομένων, χρησιμοποιήστε την επιλογή ανεβάσματος αρχείων CSV. Υποστηρίζουμε αρχεία .xlsx με ένα μόνο φύλλο. Αν ανεβάσεις αρχείο με περισσότερα από ένα φύλλα, μόνο το πρώτο θα επεξεργαστεί. Η πρώτη σειρά στο φύλλο σου πρέπει να περιέχει τα ονόματα των στηλών. Το αρχείο πρέπει να περιέχει τουλάχιστον μία στήλη με ονόματα, η στήλη χώρας είναι προαιρετική. Για λόγους προστασίας δεδομένων, τα ανεβασμένα αρχεία θα διαγράφονται αυτόματα μετά από ένα χρόνο. Κατέβασε δείγμα αρχείου εδώ. Παράδειγμα:
Παράδειγμα Excel

Βρήκα ένα σφάλμα. Τι πρέπει να κάνω;

Εκτιμούμε πολύ τη βοήθειά σου. Στείλε μας ένα email στο contact gender-api.com και θα προσπαθήσουμε να διορθώσουμε αυτό το σφάλμα το συντομότερο δυνατό.

Είναι η GENDER-API συμβατή με τον Γενικό Κανονισμό για την Προστασία Δεδομένων (GDPR);

Όλες οι υπηρεσίες του Gender-API.com συμμορφώνονται πλήρως με τον GDPR. Παρέχουμε μια Σύμβαση Επεξεργασίας Δεδομένων (DPA), η οποία σου επιτρέπει να συμμορφώνεσαι με τις υποχρεώσεις σου σύμφωνα με τον GDPR. Μπορείς να ζητήσεις αυτήν τη σύμβαση here στον λογαριασμό σου. Ένα δείγμα σύμβασης μπορεί να κατέβει here. Επίσης, μπορείς να βρεις περισσότερες πληροφορίες για το πώς προστατεύουμε τα δεδομένα σου here.

Παρέχετε βιβλιοθήκες για γλώσσες προγραμματισμού;

Λόγω της απλότητας του API μας, δεν παρέχουμε βιβλιοθήκη για οποιαδήποτε γλώσσα προγραμματισμού, εκτός από το jQuery Plugin. Οι περισσότερες γλώσσες υποστηρίζουν έναν αναλυτή json έτοιμο προς χρήση και για σχεδόν κάθε άλλη γλώσσα, υπάρχει ήδη μια εξωτερική βιβλιοθήκη που μπορείς να χρησιμοποιήσεις. Ρίξε μια ματιά στα παραδείγματα κώδικα μας για να ξεκινήσεις να χρησιμοποιείς το API:

Πρώτα εγκατάστησε τη βιβλιοθήκη μας με το composer:

composer require gender-api/client
<?php

use GenderApi\Client as GenderApiClient;

$client = new GenderApiClient('your-api-key');

// Simple gender lookup
$result = $client->getByFirstName('Elisabeth');

if ($result->genderFound()) {
    echo $result->getGender();    // "female"
    echo $result->getAccuracy();  // 99
}

// First name with country (e.g., "Andrea" varies by country)
$result = $client->getByFirstNameAndCountry('Andrea', 'IT');
echo $result->getGender(); // "male" (in Italy)

// Full name with automatic first/last name splitting
$result = $client->getByFirstNameAndLastName('Sandra Miller');

echo $result->getFirstName(); // "Sandra"
echo $result->getLastName();  // "Miller"
echo $result->getGender();    // "female"

// Email address analysis
$result = $client->getByEmailAddress('elisabeth.smith@company.com');
echo $result->getGender();  // "female"

// Batch processing - multiple names in one call
$names = ['Michael', 'Sarah', 'Kim'];
$results = $client->getByMultipleNames($names);

foreach ($results as $result) {
    printf(
        "%s: %s (%d%% confidence)\n",
        $result->getFirstName(),
        $result->getGender(),
        $result->getAccuracy()
    );
}

Δες την πλήρη τεκμηρίωση του πελάτη εδώ:

https://github.com/markus-perl/gender-api-client

Πρώτα εγκατάστησε τη βιβλιοθήκη μας με το npm:

Δες την πλήρη τεκμηρίωση του πελάτη εδώ:

https://github.com/markus-perl/gender-api-client-npm

Πρώτα εγκατάστησε τη βιβλιοθήκη μας με το npm:

Δες την πλήρη τεκμηρίωση του πελάτη εδώ:

https://github.com/markus-perl/gender-api-client-npm

Κατεβάστε ένα δείγμα έργου εδώ:

Τεκμηρίωση:

https://github.com/microknights/Gender-API

Πώς μετριούνται τα αιτήματα;

Κάθε λογαριασμός θα ανανεώνεται σε 100 αιτήματα την πρώτη ημέρα κάθε μήνα, αν έχουν μείνει λιγότερα από αυτόν τον αριθμό αιτημάτων. Μόνο αν βρεθεί ένα αποτέλεσμα, το αίτημα θα μετρηθεί. Μία αναζήτηση ονόματος θα μετράει ως ένα αίτημα. Αν ζητηθούν πολλαπλά ονόματα σε ένα ερώτημα, κάθε όνομα θα μετράει ως ένα μεμονωμένο αίτημα.

Πού μπορώ να βρω και να διαχειριστώ τα κλειδιά API μου;

Δημιουργούμε ένα αρχικό API key όταν εγγράφεσαι για έναν λογαριασμό στο Gender-API.com. Μπορείς να βρεις αυτό το API key στο κάτω μέρος της σελίδας επισκόπησης του λογαριασμού σου. Αν θέλεις να ανακαλέσεις αυτό το κλειδί, κάνε κλικ στο κουμπί "Revoke and Regenerate". Το σύστημά μας θα ακυρώσει τότε το υπάρχον API key και θα δημιουργήσει ένα νέο. Όλες οι εφαρμογές σου που χρησιμοποιούν το παλιό token δεν θα μπορούν πλέον να έχουν πρόσβαση στο API μας μέχρι να αντικαταστήσεις αυτόν τον κωδικό με το νέο API key. Στιγμιότυπο οθόνης του πλαισίου κλειδιού API Μπορείς επίσης να δημιουργήσεις περισσότερα από ένα API key. Αυτό είναι χρήσιμο, για παράδειγμα, αν έχεις πολλαπλές εφαρμογές στις οποίες θέλεις να συμπεριλάβεις το API μας. Λάβετε υπόψη ότι δεν υπάρχει διαφορά μεταξύ των κλειδιών και του πόσες αιτήσεις έχει χρησιμοποιήσει το καθένα. Όλες οι αιτήσεις μετριούνται συλλογικά. Για να διαχειριστείς ή να δημιουργήσεις πολλαπλά API κλειδιά, κάνε κλικ στο κουμπί "Ρυθμίσεις" στο μενού του λογαριασμού και μετά στο "API Κλειδιά". Διαχείριση πολλαπλών [API keys] Κάνοντας κλικ στο κουμπί "Δημιουργία Νέου Κλειδιού", μπορείς να δημιουργήσεις ένα νέο API κλειδί. Μπορείς να δώσεις σε κάθε τοκεν ένα όνομα για να το αναγνωρίζεις ευκολότερα αργότερα, από πού έχει χρησιμοποιηθεί αυτό το κλειδί. Μπορείς να αλλάξεις αυτό το όνομα οποιαδήποτε στιγμή. Επίσης, κάποια από τα widgets μας θα δημιουργήσουν αυτόματα ένα κλειδί εδώ. Για παράδειγμα, αν χρησιμοποιήσεις το "Widget Γρήγορης Αναζήτησης" στο λογαριασμό σου, το σύστημά μας θα δημιουργήσει ένα κλειδί εκ των προτέρων, και αυτό το widget θα χρησιμοποιήσει το συγκεκριμένο τοκεν για να αιτεί την API μας. Επιπλέον, εφαρμογές τρίτων θα δημιουργήσουν ένα κλειδί εδώ όταν συνδεθούν. Κάθε τοκεν μπορεί να ανακληθεί οποιαδήποτε στιγμή απλά κάνοντας κλικ στο "x". Μόλις ανακληθεί, η συνδεμένη εφαρμογή δεν θα έχει πια πρόσβαση στην API μας.

Μπορώ να μοιραστώ τον λογαριασμό μου με πολλούς ανθρώπους;

Μπορείς να μοιραστείς τον λογαριασμό σου με έως 50 ακόμη συναδέλφους ή άλλα άτομα που σχετίζονται με το έργο σου στον λογαριασμό σου. Για να διαχειριστείς την ομάδα σου, συνδέσου στον λογαριασμό σου και, στο μενού του λογαριασμού, κάνε κλικ στο "Ρυθμίσεις" => "Διαχείριση της Ομάδας σου". Σε αυτή τη σελίδα, κάνε κλικ στο "Πρόσκληση νέου μέλους" για να καλέσεις άτομα στην ομάδα σου μέσω email. Όταν προσκαλείς μέλη, μπορείς να επιλέξεις ανάμεσα σε δύο διαφορετικούς τύπους λογαριασμού. Α) Οι χρήστες μπορούν να βλέπουν, να δημιουργούν, να ενημερώνουν και να διαγράφουν API κλειδιά, να ανεβάζουν και να καθορίζουν το φύλο αρχείων CSV και Excel, να έχουν πρόσβαση σε όλα τα API endpoints, να αγοράζουν αιτήσεις και να συνδέουν εφαρμογές τρίτων. B) Οι διαχειριστές μπορούν να κάνουν ό,τι και οι χρήστες, επιπλέον μπορούν να ενημερώνουν τις ρυθμίσεις και τη διεύθυνση χρέωσης του λογαριασμού, να δημιουργούν και να βλέπουν συμφωνίες επεξεργασίας δεδομένων, να προσκαλούν, να ενημερώνουν και να διαγράφουν μέλη της ομάδας.

Μπορώ να προστατέψω τον λογαριασμό μου ενεργοποιώντας την επαλήθευση δύο βημάτων;

Μπορείς να προστατέψεις τον λογαριασμό σου ενεργοποιώντας την επαλήθευση δύο βημάτων. Για να ενεργοποιήσεις αυτό το πρόσθετο μέτρο ασφαλείας, συνδέσου στον λογαριασμό σου και, στο μενού λογαριασμών, κάνε κλικ στο "Ρυθμίσεις" => "Αλλαγή Κωδικού / 2FA". Βεβαιώσου ότι έχεις εγκαταστήσει μια εφαρμογή αυθεντικοποίησης στο τηλέφωνό σου. Συνιστούμε τη χρήση μιας εφαρμογής όπως η Authy (App Store, Play Store) ή Google Authenticator (App Store, Play Store). Στη συνέχεια, κάνε κλικ στο κουμπί "Ενεργοποίηση Τώρα" και ακολούθησε τις οδηγίες στην οθόνη. Μπορείς να προσθέσεις πολλαπλές συσκευές εδώ για να διασφαλίσεις, για παράδειγμα, ότι θα εξακολουθείς να έχεις πρόσβαση στον λογαριασμό σου μετά την απώλεια μιας συσκευής. Μόλις ενεργοποιηθεί, θα απαιτείται να εισάγεις τον κωδικό που δημιουργείται από την εφαρμογή αυθεντικοποίησης του τηλεφώνου σου για να συνδεθείς επιτυχώς.

Μπορώ να χρησιμοποιήσω εφαρμογές τρίτων όταν είναι ενεργοποιημένη η δύο-παραγόντων επαλήθευση;

Κάποιες ενσωματώσεις ή εφαρμογές τρίτων λειτουργούν άψογα με ενεργοποιημένη την επαλήθευση δύο βημάτων. Άλλες ίσως χρειάζονται σύνδεση χωρίς την επαλήθευση δύο βημάτων. Αν έχεις προβλήματα σύνδεσης σε κάποια εφαρμογή με τα στοιχεία σύνδεσής σου στο Gender-API.com, συνδέσου απευθείας στον λογαριασμό σου στο Gender-API και κάνε κλικ στο "Settings" => "Change Password / 2FA" στο μενού του λογαριασμού. Έπειτα, κάνε κλικ στην καρτέλα "Two-Step Verification" και όρισε το "Third-party app access" σε "Not restricted". Σημείωσε ότι μπορείς να αλλάξεις αυτήν τη ρύθμιση μόνο αν είναι ενεργοποιημένη η επαλήθευση δύο βημάτων.

Ποια είναι η διαφορά μεταξύ ενός πληρωμένου και ενός δωρεάν λογαριασμού;

Και οι δύο τύποι λογαριασμών προσφέρουν την ίδια λειτουργικότητα. Όλα τα [API endpoints] είναι διαθέσιμα και για τους δύο τύπους λογαριασμών και θα επιστρέφουν τα ίδια αποτελέσματα. Οι δωρεάν λογαριασμοί περιορίζονται σε έναν συγκεκριμένο αριθμό αιτημάτων ανά μήνα. Όταν εγγραφείς, 100 αιτήματα είναι άμεσα διαθέσιμα σε εσένα δωρεάν. Την πρώτη μέρα κάθε μήνα, το σύστημά μας θα επαναφέρει αυτόν τον αριθμό, και τα δωρεάν αιτήματα θα είναι ξανά διαθέσιμα. Παρακαλώ δημιούργησε μόνο έναν λογαριασμό. Αν χρειάζεσαι περισσότερα αιτήματα, μπορείς να αναβαθμίσεις σε ένα από τα πληρωμένα πλάνα μας οποιαδήποτε στιγμή εδώ.

Πώς μπορώ να αποσυνδεθώ από όλες τις συσκευές;

Αν κάνεις κλικ στο κουμπί αποσύνδεσης στον λογαριασμό σου, θα αποσυνδεθείς μόνο από την τρέχουσα συσκευή σου. Για να εξασφαλίσεις την ασφάλεια του λογαριασμού και των δεδομένων σου, είναι σημαντικό να αποσυνδέεσαι από όλες τις συσκευές όταν απαιτείται. Παρακαλώ ακολούθησε τις παρακάτω οδηγίες για να αποσυνδεθείς επιτυχώς από όλες τις συσκευές στην πλατφόρμα API μας. Όταν είσαι συνδεδεμένος, κάνε κλικ εδώ για να αποσυνδεθείς από όλες τις συσκευές. Επίσης, αν αλλάξεις τον κωδικό πρόσβασης ή τροποποιήσεις τις ρυθμίσεις της δύο-παραγόντων ταυτοποίησης (2FA), το σύστημα θα σε αποσυνδέσει αυτόματα από όλες τις συσκευές που δεν αντιστοιχούν στη τρέχουσα διεύθυνση IP σου. Αυτό προσθέτει ένα επιπλέον επίπεδο ασφάλειας στον λογαριασμό σου. Η δημιουργία ξεχωριστών λογαριασμών για κάθε μέλος της ομάδας συνιστάται για να ενισχυθεί η ασφάλεια και να διευκολυνθεί η συνεργασία της ομάδας. Επιπλέον, για να ενισχύσεις την ασφάλεια του λογαριασμού σου, συνιστούμε ανεπιφύλακτα να ενεργοποιήσεις την Δύο-Παραγόντων Ταυτοποίηση (2FA). Αυτό το επιπλέον επίπεδο προστασίας προσθέτει ένα επιπλέον βήμα στη διαδικασία σύνδεσης, καθιστώντας πιο δύσκολο για μη εξουσιοδοτημένα άτομα να αποκτήσουν πρόσβαση.

Ποια είναι η διαφορά μεταξύ μιας συνδρομής και μιας εφάπαξ πληρωμής;

Αν θέλεις να αγοράσεις ένα από τα πακέτα μας, μπορείς να επιλέξεις μεταξύ μιας εφάπαξ πληρωμής ή μιας συνδρομής σε αυτό το πακέτο. Οι συνδρομές είναι προτεινόμενες αν θέλεις να χρησιμοποιείς την υπηρεσία μας τακτικά. Μπορείς να είσαι σίγουρος ότι θα υπάρχουν πάντα αρκετά αιτήματα στον λογαριασμό σου. Τα αιτήματα που αγοράζονται με συνδρομή μπορούν να χρησιμοποιηθούν μέσα σε ένα μήνα. Με ενεργή συνδρομή, το σύστημά μας θα επαναφορτίσει τον λογαριασμό σου μετά από ένα μήνα στο επιλεγμένο ποσό αιτημάτων. Για παράδειγμα, αν έχεις συνδρομή στο πακέτο με 25.000 αιτήματα και έχεις χρησιμοποιήσει 21.500, το σύστημά μας θα αναπληρώσει τον λογαριασμό σου στα 25.000 αιτήματα μετά από ένα μήνα. Τα εφάπαξ πακέτα μπορούν να αγοραστούν για μια μοναδική περίπτωση χρήσης και μπορούν να χρησιμοποιηθούν μέσα σε ένα έτος. Για παράδειγμα, αν θέλεις να επεξεργαστείς ένα αρχείο Excel ή CSV, προτείνουμε την εφάπαξ αγορά. Οι εφάπαξ αγορές δεν ανανεώνονται. Πρέπει να βεβαιωθείς ότι δεν θα εξαντληθούν τα αιτήματά σου. Μπορείς να αλλάξεις μεταξύ και των δύο τύπων πακέτων στη purchase page Σε παρακαλώ μην αναμειγνύεις και τους δύο τύπους αγοράς μέχρι να μιλήσεις πρώτα με την υποστήριξή μας ή να ξέρεις ακριβώς τι κάνεις. Η αγορά ενός πακέτου μιας φοράς ενώ είσαι συνδρομητής σε ένα από τα πακέτα μας μπορεί να αποτρέψει τη συνδρομή από το να ανατροφοδοτήσει τις αιτήσεις σου. Για παράδειγμα, όταν υπάρχουν περισσότερες αιτήσεις από την αγορά μιας φοράς, από ό,τι θα ανατροφοδοτούσε η συνδρομή.

Χρειάζομαι ένα πιστοποιητικό κατοικίας. Μπορείς να εκδόσεις ένα τέτοιο πιστοποιητικό;

Αν χρειάζεσαι ένα πιστοποιητικό κατοικίας από την εταιρεία μας, παρακαλώ επικοινώνησε με το support για το αίτημά σου. Το πιστοποιητικό πρέπει να ζητηθεί ξεχωριστά για κάθε εταιρεία. Συμπερίλαβε στο αίτημά σου την πλήρη διεύθυνση της εταιρείας σου, τη χώρα κατοικίας σου, και, αν είναι διαθέσιμο, τον αριθμό φορολογικού μητρώου σου. Το πιστοποιητικό κατοικίας πρέπει να υπογραφεί από το φορολογικό μας γραφείο. Συνήθως χρειάζονται 2-3 εβδομάδες για να παραλάβουμε την υπογεγραμμένη φόρμα, την οποία μπορούμε μετά να παρέχουμε ως ένα ψηφιακό αντίγραφο. Στιγμιότυπο Πιστοποιητικό Κατοικίας

Πώς μπορώ να αγοράσω ένα πακέτο / περισσότερα αιτήματα;

Μπορείς να επιλέξεις μεταξύ ενός συνδρομητικού προγράμματος ή μιας εφάπαξ πληρωμής here. Η εφάπαξ πληρωμή προτείνεται, αν θέλεις να επεξεργαστείς ένα μεγάλο αρχείο CSV ή αν προτιμάς να χρησιμοποιείς τα αιτήματά σου σε ακανόνιστα διαστήματα. Μπορείς να χρεώσεις τον λογαριασμό σου με τον απαραίτητο αριθμό αιτημάτων όποτε θέλεις. Τα αιτήματα που αγοράζονται με την εφάπαξ πληρωμή μπορούν να χρησιμοποιηθούν εντός ενός έτους. Αν προτιμάς να εγγραφείς σε ένα συνδρομητικό πρόγραμμα, ο λογαριασμός σου θα γεμίζει με τον επιλεγμένο αριθμό αιτημάτων κάθε μήνα. Οι συνδρομές μπορούν να αλλάξουν ή να ακυρωθούν οποιαδήποτε στιγμή.

Πώς μπορώ να ακυρώσω τη συνδρομή μου?

Μπορείς να αλλάξεις ή να ακυρώσεις τη συνδρομή σου οποιαδήποτε στιγμή here. Εάν θέλεις να σταματήσεις τις επαναλαμβανόμενες πληρωμές, κάνε κλικ στο κουμπί "Ακύρωση αυτής της συνδρομής".
Συνομιλία