Πιστοποίηση (Authentication)

Όλα τα API αιτήματα προς το GenderAPI απαιτούν πιστοποίηση. Μπορείς να πιστοποιήσεις τα αιτήματά σου με δύο τρόπους:

1. API Key στο σώμα του POST ως παράμετρος key
2. API Key στην κεφαλίδα Authorization χρησιμοποιώντας Bearer token

1. API Key στο Σώμα του POST

Ο πιο απλός τρόπος πιστοποίησης είναι να συμπεριλάβεις το API key σου ως πεδίο key μέσα στο JSON σώμα του POST αιτήματός σου.

Για παράδειγμα, για να καθορίσεις το φύλο του ονόματος «Alice»:

Παράδειγμα με cURL

curl -X POST "https://api.genderapi.io/api" \
     -H "Content-Type: application/json" \
     -d '{"name": "Alice", "key": "YOUR_API_KEY"}'

Παράδειγμα με JavaScript fetch

fetch("https://api.genderapi.io/api", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    name: "Alice",
    key: "YOUR_API_KEY"
  })
})
.then(response => response.json())
.then(data => console.log(data));

Παράδειγμα με Python requests

import requests

url = "https://api.genderapi.io/api"

payload = {
    "name": "Alice",
    "key": "YOUR_API_KEY"
}

headers = {
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers, json=payload)

print(response.json())

2. API Key στην κεφαλίδα Authorization (Bearer Token)

Για μεγαλύτερη ασφάλεια και καθαρότερα αιτήματα, μπορείς να στείλεις το API key σου στην κεφαλίδα Authorization χρησιμοποιώντας το Bearer schema. Με αυτή τη μέθοδο, δεν περιλαμβάνεις το API key στο σώμα του JSON.

Αντί γι’ αυτό, στο σώμα του POST περιλαμβάνεις μόνο τις παραμέτρους εισόδου σου (όπως το name).

Για παράδειγμα, για να καθορίσεις το φύλο του ονόματος «Alice»:

Παράδειγμα με cURL

curl -X POST "https://api.genderapi.io/api" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{"name": "Alice"}'

Παράδειγμα με JavaScript fetch

fetch("https://api.genderapi.io/api", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    name: "Alice"
  })
})
.then(response => response.json())
.then(data => console.log(data));

Παράδειγμα με Python requests

import requests

url = "https://api.genderapi.io/api"

payload = {
    "name": "Alice"
}

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.post(url, headers=headers, json=payload)

print(response.json())

Επιλογή μεταξύ των δύο μεθόδων

Και οι δύο μέθοδοι πιστοποίησης υποστηρίζονται από όλα τα API endpoints. Ωστόσο, η χρήση της κεφαλίδας Authorization είναι πιο ασφαλής γιατί κρατά το API key σου εκτός του σώματος του αιτήματος και αποτρέπει την τυχαία καταγραφή του.

Ανεξαρτήτως της μεθόδου που θα επιλέξεις, φρόντισε πάντα να θέτεις την κεφαλίδα Content-Type σε application/json κατά την αποστολή POST αιτημάτων.