Personal Data API

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

1. 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=

2. 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").

3. 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

1. 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"]
    }
}

1. 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"]
    }
}

1. 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"]
    }
}

1. 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:

1. Brak parametru lang:
   Kopiuj

   {
       "error": "Invalid or missing parameter. Use ie. ?lang=pl"
   }
   

2. Nieprawidłowy parametr:
   Kopiuj

   {
       "error": "Invalid or missing parameter. Use ?male_names= or ?female_names= to get the data."
   }
   

Przykłady użycia

1. Pobranie pełnej listy imion męskich:
   GET https://infinityhost.ct8.pl/personal_data.php?lang=pl&male_names=

2. Wyszukanie imion żeńskich zaczynających się od "An":
   GET https://infinityhost.ct8.pl/personal_data.php?lang=pl&female_names=An

3. 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.

Tylko po co? Przecież istnieją już takie narzędzia i to dużo lepsze jak https://fakeit.receivefreesms.co.uk/

hzmzp napisał(a):

Tylko po co? Przecież istnieją już takie narzędzia i to dużo lepsze jak https://fakeit.receivefreesms.co.uk/

Baza danych, żeby szybko dostać jakiś zbiór do testów. Tysiąc razy takiego potrzebowałem.

Co zawiera ta strona, ze CyberTarcza na nią nie wpuszcza?

somekind napisał(a):

Co zawiera ta strona, ze CyberTarcza na nią nie wpuszcza?

Dużo może być powodów, rasizm, nietolerancja, ksenofobia itp.

Może masz jakieś błędy, bo Firefox też mi nie pozwala na nią wejść.

lion137 napisał(a):

Może masz jakieś błędy, bo Firefox też mi nie pozwala na nią wejść.

Może ISP Ci geoblokadę założył?

Takie coś mam:

Proszę Państwa była mała nieprawidłowość , nazwy tablic z nazwiskami przestawione ale już wszystko naprawione.

Oto przykład użycia https://infinityhost.ct8.pl/code_14/

po co tak koniecznie api wymusza parametr lang skoro jego zawartość nie ma znaczenia i zwraca to samo?

obscurity napisał(a):

po co tak koniecznie api wymusza parametr lang skoro jego zawartość nie ma znaczenia i zwraca to samo?

Bo mój drogi lada moment dodam więcej opcji (właśnie przygotowuję drugie api). Bądź cierpliwy and You will be given. Będzie sztos. It's gonna be huge my friend!

obscurity napisał(a):

po co tak koniecznie api wymusza parametr lang skoro jego zawartość nie ma znaczenia i zwraca to samo?

Masz rację , mój błąd.

@somekind o tym piszę

@johnny_Be_good - to są karty przeglądarki. Ale o co chodzi?