Dokumentacja API Unified API v2.0

API v1.0

Oferujemy także inną wersję naszego interfejsu API z punktami końcowymi, które są łatwiejsze do zintegrowania. Jeśli dopiero zaczynasz implementować API, możesz przełączyć się na nasz punkt końcowy v1.0.

Kody błędów

Status endpoint-not-found
HTTP Status Code 404
Description API endpoint not found
Status limit-exceeded
HTTP Status Code 401
Description Limit exceeded. Thank you for using our service. Please consider to buy more requests.
Status parameter-first-name-invalid
HTTP Status Code 400
Description The "first_name" parameter is invalid. The parameter can only be a string with a length from 1 to 50 chars.
Status parameter-full-name-invalid
HTTP Status Code 400
Description The "full_name" parameter is invalid. The parameter can only be a string with a length from 3 to 100 chars.
Status parameter-email-invalid
HTTP Status Code 400
Description The "email" parameter is invalid. The parameter can only be a string with a length from 3 to 100 chars and must be a valid email address.
Status key-parameter-missing
HTTP Status Code 400
Description The "key" parameter is not set. Please create an account to fetch an API key.
Status invalid-key
HTTP Status Code 400
Description Invalid API key. You can find your personal API key in your account.
Status invalid-country-code
HTTP Status Code 400
Description The given country code is not valid. You can find a list of valid country codes in our API docs.
Status invalid-ip-address
HTTP Status Code 400
Description The given ip address is not valid. Please provide either a valid IPv4 or an IPv6 address.
Status generic-error
HTTP Status Code 400
Description
Status invalid-json
HTTP Status Code 400
Description
Status invalid-locale
HTTP Status Code 400
Description The given locale is not valid. You can find a list of valid country codes in our API docs.
Status invalid-id
HTTP Status Code 400
Description The given id is not valid. An id can be either an integer or a string with 50 chars at max.
Status mandatory-parameter-missing
HTTP Status Code 400
Description Mandatory parameter missing. Either first_name, full_name or email must be set.
Status content-type-missing
HTTP Status Code 400
Description Content-Type missing. Please add a "Content-Type: application/json" to your API call.
Status missing-json
HTTP Status Code 400
Description We weren't able to find a json body in your API call. Please make sure the body is sent with a POST request to our API endpoint.
Status too-many-queries
HTTP Status Code 400
Description Too many queries in a single API call.
Status too-many-queries-api-key
HTTP Status Code 400
Description Too many queries in a single API call. Your API key is limited to 3 lookups per request.
Status authorization-header-missing
HTTP Status Code 400
Description Your query misses the "Authorization" header with the bearer token.
Status invalid-auth-token
HTTP Status Code 400
Description Invalid authentication token provided. Please log in to your account to find a list of valid tokens or to create a new one.
Status email-invalid
HTTP Status Code 400
Description Invalid or empty email address given.
Status password-invalid
HTTP Status Code 400
Description Invalid credentials. Login failed. Please also check your account that third-party app access is not restricted.: https://gender-api.com/de/account/password
Status label-invalid
HTTP Status Code 400
Description Invalid label given. A label must be a string between 2 and 30 chars.
Status email-account-not-found
HTTP Status Code 400
Description No Gender-API.com account found. Please create a free account first, to sign-in with Google or try to login with an existing username or password.
Status invalid-list-of-names
HTTP Status Code 400
Description Invalid list of names. Expected array of strings.
Ten produkt zawiera dane GeoLite2 utworzone przez firmę MaxMind, dostępne z http://www.maxmind.com.
Czat
Potrzebujemy twojej zgody
Używamy plików cookie (w tym plików cookie podmiotów trzecich), aby zbierać informacje o korzystaniu przez odwiedzających z naszej strony internetowej. Pliki cookie te pomagają nam zapewnić najlepsze możliwe wrażenia z korzystania z naszej strony internetowej oraz ciągłe doskonalenie naszych stron. Informacje zbierane za pomocą plików cookie mogą być przetwarzane także poza Unią Europejską, np. w USA. Klikając przycisk "Akceptuj wszystko", zgadasz się na korzystanie z plików cookie. Aby cofnąć zgodę w każdej chwili, zmienić ustawienia lub uzyskać więcej informacji dotyczących wykorzystywania plików cookies, kliknij tutaj lub "Ustawienia plików cookie" na końcu strony.