NamesAPP

Документация API

🚀 Начало работы

Для начала работы с API NamesAPP, необходимо зарегистрироваться и войти на сайт.

На странице профиля вы найдёте API Token, необходимый для доступа к API. Там же указано доступное количество запросов.

⚙️ Доступные эндпоинты API

➡️ /api/get_gender_by_name

Эндпоинт позволяет получить пол человека по его имени.

Обязательные параметры в строке запроса:

  • name: string – имя, по которому нужно определить пол;
  • token: string – ваш API Token.

Например, для имени "Александр" запрос будет выглядеть следующим образом:

curl -X 'GET' \
  'https://nameapp.anverali.tech/api/get_gender_by_name?name=%D0%90%D0%BB%D0%B5%D0%BA%D1%81%D0%B0%D0%BD%D0%B4%D1%80&token=5gmLKYqq-jVEcwk57-bi6pmXGD-KzN8F3Y5' \
  -H 'accept: application/json'

✅ Пример ответа от сервиса:

male

Возможные варианты ответа:

  • male: мужской пол.
  • female: женский пол.
  • unknown: имени пока нет в базе, или оно некорректное.

❌ В случае, если у вас недостаточно запросов, сервис вернёт ответ со статус кодом 400:

{
  "detail": "Пополните баланс"
}

Пополнить баланс можно со страницы тарифов.

Если у вас остались вопросы по работе с сервисом – задайте их, и мы постараемся помочь вам как можно скорее!