Методы API

cultures.list

Справочник происхождений

Все культуры/традиции происхождения с числом имён.

Без параметров.

curl -s https://namecandies.gumeniuk.com/rpc -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"cultures.list","params":{}}'

namedays.byDate

Именины на дату

Имена с именинами в указанный день по православному месяцеслову (курированное ядро, покрытие неполное).

curl -s https://namecandies.gumeniuk.com/rpc -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"namedays.byDate","params":{}}'

names.filter

Подбор имён по фильтрам

Фильтры: пол, культура, первая буква, длина, редкость, сортировка. Пагинация — keyset-курсором (next_cursor), общего количества нет. Редкость считается по данным US SSA 1880–2008.

curl -s https://namecandies.gumeniuk.com/rpc -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"names.filter","params":{}}'

names.get

Полная карточка имени

Возвращает всё об одном имени: написания, значение, происхождение, связанные имена, именины и популярность. Укажите ровно один идентификатор: slug или public_id.

curl -s https://namecandies.gumeniuk.com/rpc -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"names.get","params":{}}'

names.search

Поиск имени

Двухфазный поиск: точное/префиксное совпадение по нормализованному написанию, затем похожие (trigram). Регистр, ё/е и латинская транслитерация нормализуются: «Алёна», «алена» и «Alena» находят одно имя.

curl -s https://namecandies.gumeniuk.com/rpc -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"names.search","params":{}}'

names.similar

Похожие имена

До 8 имён, близких по звучанию и того же пола.

curl -s https://namecandies.gumeniuk.com/rpc -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"names.similar","params":{}}'

popularity.series

Динамика популярности

Ряд популярности имени по годам. ИСТОЧНИК: данные США (SSA), 1880–2008 — не российская статистика; трактуйте с этой оговоркой.

curl -s https://namecandies.gumeniuk.com/rpc -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"popularity.series","params":{}}'

rpc.discover

Return the service's OpenRPC description

The service-discovery method from the OpenRPC specification: returns the OpenRPC 1.3.2 document describing every public method, its param/result schemas, and its documentation.

Без параметров.

curl -s https://namecandies.gumeniuk.com/rpc -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"rpc.discover","params":{}}'