API: Personal Data API
Personal Data API to lekkie i proste w użyciu API, które pozwala użytkownikom uzyskać dane osobowe, takie jak imiona i nazwiska męskie oraz żeńskie. API obsługuje filtrowanie danych na podstawie prefiksów, co ułatwia wyszukiwanie konkretnego fragmentu imienia lub nazwiska. Jest to idealne narzędzie do zastosowań w aplikacjach generujących losowe dane lub w systemach wspierających zarządzanie danymi.
Funkcjonalności
-
Pobieranie list imion i nazwisk
Użytkownik może pobrać pełne listy imion i nazwisk męskich i żeńskich.
Przykład: ?male_names= -
Filtrowanie wyników
Użytkownik może wyszukiwać imiona lub nazwiska, które zaczynają się od określonego fragmentu.
Przykład: ?male_names=Ad (zwróci imiona męskie zaczynające się od "Ad"). -
Zwrot informacji w formacie JSON
Wszystkie odpowiedzi są zwracane w przyjaznym dla maszyn formacie JSON, co umożliwia łatwą integrację z aplikacjami.API docelowo będzie obsługiwać wiele języków poprzez parametr
lang
.
Endpointy
- Pobieranie imion męskich
Endpoint:https://infinityhost.ct8.pl/personal_data.php
Parametry:
lang
: Wymagany. Kod języka (np.pl
).
male_names
: Opcjonalny. Fragment imienia lub pusty ciąg.
Przykład zapytania:
Pobranie wszystkich imion:
GET https://infinityhost.ct8.pl/personal_data.php?lang=pl&male_names
Wyszukiwanie imion zaczynających się od "Ad":
GET https://infinityhost.ct8.pl/personal_data.php?lang=pl&male_names=Ad
Przykład odpowiedzi:
{
"male_names": {
"size": 2,
"names": ["Adam", "Adrian"]
}
}
- Pobieranie nazwisk męskich
Endpoint:https://infinityhost.ct8.pl/personal_data.php
Parametry:
lang
: Wymagany. Kod języka (np.pl
). - obecnie obsługuje jedynie polski
male_surnames
: Opcjonalny. Fragment nazwiska lub pusty ciąg.
Przykład zapytania:
Pobranie wszystkich nazwisk:
GET https://infinityhost.ct8.pl/personal_data.php?lang=pl&male_surnames
Wyszukiwanie nazwisk zaczynających się od "Ko":
GET https://infinityhost.ct8.pl/personal_data.php?lang=pl&male_surnames=Ko
Przykład odpowiedzi:
{
"male_surnames": {
"size": 3,
"names": ["Kowalski", "Konieczny", "Kostrzewa"]
}
}
- Pobieranie imion żeńskich
Endpoint:https://infinityhost.ct8.pl/personal_data.php
Parametry:
lang
: Wymagany. Kod języka (np.pl
).
female_names
: Opcjonalny. Fragment imienia lub pusty ciąg.
Przykład zapytania:
Pobranie wszystkich imion:
GET https://infinityhost.ct8.pl/personal_data.php?lang=pl&female_names
Wyszukiwanie imion zaczynających się od "Ma":
GET https://infinityhost.ct8.pl/personal_data.php?lang=pl&female_names=Ma
Przykład odpowiedzi:
{
"female_names": {
"size": 1,
"names": ["Maria"]
}
}
- Pobieranie nazwisk żeńskich
Endpoint:https://infinityhost.ct8.pl/personal_data.php
Parametry:
lang
: Wymagany. Kod języka (np.pl
).
female_surnames
: Opcjonalny. Fragment nazwiska lub pusty ciąg.
Przykład zapytania:
Pobranie wszystkich nazwisk:
GET https://infinityhost.ct8.pl/personal_data.php?lang=pl&female_surnames
Wyszukiwanie nazwisk zaczynających się od "Now":
GET https://infinityhost.ct8.pl/personal_data.php?lang=pl&female_surnames=Now
Przykład odpowiedzi:
{
"female_surnames": {
"size": 1,
"names": ["Nowak"]
}
}
Obsługa błędów
API zwraca czytelne komunikaty błędów w następujących sytuacjach:
- Brak parametru
lang
:{ "error": "Invalid or missing parameter. Use ie. ?lang=pl" }
- Nieprawidłowy parametr:
{ "error": "Invalid or missing parameter. Use ?male_names= or ?female_names= to get the data." }
Przykłady użycia
-
Pobranie pełnej listy imion męskich:
GET https://infinityhost.ct8.pl/personal_data.php?lang=pl&male_names=
-
Wyszukanie imion żeńskich zaczynających się od "An":
GET https://infinityhost.ct8.pl/personal_data.php?lang=pl&female_names=An
-
Pobranie nazwisk męskich bez filtrowania:
GET https://infinityhost.ct8.pl/personal_data.php?lang=pl&male_surnames=
Personal Data API to szybkie i efektywne narzędzie do pobierania danych osobowych w uporządkowanym formacie JSON. Dzięki elastycznym opcjom filtrowania można łatwo dopasować wyniki do swoich potrzeb.
- screenshot-20241119100420.png (64 KB) - ściągnięć: 6