{"openrpc":"1.3.2","info":{"title":"NameCandies API","version":"data-v0.6.0"},"methods":[{"name":"cultures.list","summary":"Справочник происхождений","description":"Все культуры/традиции происхождения с числом имён.","tags":[{"name":"catalog"}],"params":[],"result":{"name":"result","schema":{"$ref":"#/components/schemas/CulturesResult"}}},{"name":"namedays.byDate","summary":"Именины на дату","description":"Имена с именинами в указанный день по православному месяцеслову (курированное ядро, покрытие неполное).","tags":[{"name":"namedays"}],"paramStructure":"by-name","params":[{"name":"month","required":true,"schema":{"type":"integer"}},{"name":"day","required":true,"schema":{"type":"integer"}}],"result":{"name":"result","schema":{"$ref":"#/components/schemas/NamedaysResult"}}},{"name":"names.filter","summary":"Подбор имён по фильтрам","description":"Фильтры: пол, культура, первая буква, длина, редкость, сортировка. Пагинация — keyset-курсором (next_cursor), общего количества нет. Редкость считается по данным US SSA 1880–2008.","tags":[{"name":"names"}],"paramStructure":"by-name","params":[{"name":"gender","schema":{"type":"string"}},{"name":"culture_code","schema":{"type":"string"}},{"name":"letter","schema":{"type":"string"}},{"name":"min_len","schema":{"type":"integer"}},{"name":"max_len","schema":{"type":"integer"}},{"name":"rarity","schema":{"type":"string"}},{"name":"sort","schema":{"type":"string"}},{"name":"cursor","schema":{"type":"string"}},{"name":"limit","schema":{"type":"integer"}}],"result":{"name":"result","schema":{"$ref":"#/components/schemas/FilterResult"}},"examples":[{"name":"girls-rare","params":[{"name":"gender","value":"f"},{"name":"culture_code","value":""},{"name":"letter","value":""},{"name":"min_len","value":0},{"name":"max_len","value":0},{"name":"rarity","value":"rare"},{"name":"sort","value":""},{"name":"cursor","value":""},{"name":"limit","value":3}],"result":{"name":"result","value":{"items":[{"public_id":"0b9e…","slug":"aksinya","display_name":"Аксинья","gender":"f"}],"next_cursor":"0LDQutGB…"}}}]},{"name":"names.get","summary":"Полная карточка имени","description":"Возвращает всё об одном имени: написания, значение, происхождение, связанные имена, именины и популярность. Укажите ровно один идентификатор: slug или public_id.","tags":[{"name":"names"}],"paramStructure":"by-name","params":[{"name":"slug","schema":{"type":"string"}},{"name":"public_id","schema":{"type":"string"}}],"result":{"name":"result","schema":{"$ref":"#/components/schemas/NameCard"}},"examples":[{"name":"by-slug","params":[{"name":"slug","value":"alena"},{"name":"public_id","value":""}],"result":{"name":"result","value":{"public_id":"0b9e…","slug":"alena","display_name":"Алена","gender":"f","relations":{}}}}]},{"name":"names.search","summary":"Поиск имени","description":"Двухфазный поиск: точное/префиксное совпадение по нормализованному написанию, затем похожие (trigram). Регистр, ё/е и латинская транслитерация нормализуются: «Алёна», «алена» и «Alena» находят одно имя.","tags":[{"name":"names"}],"paramStructure":"by-name","params":[{"name":"query","required":true,"schema":{"type":"string"}},{"name":"limit","schema":{"type":"integer"}}],"result":{"name":"result","schema":{"$ref":"#/components/schemas/SearchResult"}},"examples":[{"name":"basic","params":[{"name":"query","value":"алена"},{"name":"limit","value":5}],"result":{"name":"result","value":{"items":[{"public_id":"0b9e…","slug":"alena","display_name":"Алена","gender":"f","match":"exact"}]}}}]},{"name":"names.similar","summary":"Похожие имена","description":"До 8 имён, близких по звучанию и того же пола.","tags":[{"name":"names"}],"paramStructure":"by-name","params":[{"name":"public_id","required":true,"schema":{"type":"string"}},{"name":"limit","schema":{"type":"integer"}}],"result":{"name":"result","schema":{"$ref":"#/components/schemas/SimilarResult"}}},{"name":"popularity.series","summary":"Динамика популярности","description":"Ряд популярности имени по годам. ИСТОЧНИК: данные США (SSA), 1880–2008 — не российская статистика; трактуйте с этой оговоркой.","tags":[{"name":"popularity"}],"paramStructure":"by-name","params":[{"name":"public_id","required":true,"schema":{"type":"string"}}],"result":{"name":"result","schema":{"$ref":"#/components/schemas/PopularityResult"}}},{"name":"rpc.discover","summary":"Return the service's OpenRPC description","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.","params":[],"result":{"name":"result","schema":{}}}],"components":{"schemas":{"Culture":{"type":"object","properties":{"code":{"type":"string"},"kind":{"type":"string"},"name_ru":{"type":"string"}},"required":["code","name_ru","kind"]},"CultureItem":{"type":"object","properties":{"code":{"type":"string"},"kind":{"type":"string"},"name_ru":{"type":"string"},"names_count":{"type":"integer"}},"required":["code","name_ru","kind","names_count"]},"CulturesResult":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/CultureItem"}}},"required":["items"]},"FilterItem":{"type":"object","properties":{"display_name":{"type":"string"},"gender":{"type":"string"},"latest_rank":{"type":"integer"},"public_id":{"type":"string"},"slug":{"type":"string"}},"required":["public_id","slug","display_name","gender"]},"FilterResult":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/FilterItem"}},"next_cursor":{"type":"string"}},"required":["items"]},"Meaning":{"type":"object","properties":{"confidence":{"type":"string"},"culture":{"type":"string"},"is_truncated":{"type":"boolean"},"meaning":{"type":"string"}},"required":["meaning","confidence"]},"NameCard":{"type":"object","properties":{"cultures":{"type":"array","items":{"$ref":"#/components/schemas/Culture"}},"display_name":{"type":"string"},"gender":{"type":"string"},"meanings":{"type":"array","items":{"$ref":"#/components/schemas/Meaning"}},"namedays":{"type":"array","items":{"$ref":"#/components/schemas/Nameday"}},"popularity":{"type":"array","items":{"$ref":"#/components/schemas/PopularityPoint"}},"public_id":{"type":"string"},"relations":{"$ref":"#/components/schemas/Relations"},"slug":{"type":"string"},"spellings":{"type":"array","items":{"$ref":"#/components/schemas/Spelling"}}},"required":["public_id","slug","display_name","gender","relations"]},"NameRef":{"type":"object","properties":{"display_name":{"type":"string"},"gender":{"type":"string"},"public_id":{"type":"string"},"slug":{"type":"string"}},"required":["public_id","slug","display_name","gender"]},"Nameday":{"type":"object","properties":{"confidence":{"type":"string"},"day":{"type":"integer"},"month":{"type":"integer"},"saint":{"type":"string"}},"required":["month","day","confidence"]},"NamedayEntry":{"type":"object","properties":{"name":{"$ref":"#/components/schemas/NameRef"},"saint":{"type":"string"}},"required":["name"]},"NamedaysResult":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/NamedayEntry"}}},"required":["items"]},"PopularityPoint":{"type":"object","properties":{"gender":{"type":"string"},"per_100k":{"type":"number"},"rank":{"type":"integer"},"year":{"type":"integer"}},"required":["year","gender","rank","per_100k"]},"PopularityResult":{"type":"object","properties":{"series":{"type":"array","items":{"$ref":"#/components/schemas/PopularityPoint"}},"source":{"$ref":"#/components/schemas/PopularitySource"}},"required":["source","series"]},"PopularitySource":{"type":"object","properties":{"code":{"type":"string"},"title":{"type":"string"}},"required":["code","title"]},"Relations":{"type":"object","properties":{"cognates":{"type":"array","items":{"$ref":"#/components/schemas/NameRef"}},"components":{"type":"array","items":{"$ref":"#/components/schemas/NameRef"}},"diminutives":{"type":"array","items":{"$ref":"#/components/schemas/NameRef"}},"feminine_pair":{"type":"array","items":{"$ref":"#/components/schemas/NameRef"}},"full_forms":{"type":"array","items":{"$ref":"#/components/schemas/NameRef"}},"masculine_pair":{"type":"array","items":{"$ref":"#/components/schemas/NameRef"}},"part_of":{"type":"array","items":{"$ref":"#/components/schemas/NameRef"}},"spelling_variants":{"type":"array","items":{"$ref":"#/components/schemas/NameRef"}}}},"SearchItem":{"type":"object","properties":{"display_name":{"type":"string"},"gender":{"type":"string"},"match":{"type":"string"},"public_id":{"type":"string"},"slug":{"type":"string"}},"required":["public_id","slug","display_name","gender","match"]},"SearchResult":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/SearchItem"}}},"required":["items"]},"SimilarResult":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/NameRef"}}},"required":["items"]},"Spelling":{"type":"object","properties":{"display_name":{"type":"string"},"is_primary":{"type":"boolean"},"is_transliteration":{"type":"boolean"},"lang":{"type":"string"},"script":{"type":"string"},"spelling":{"type":"string"}},"required":["lang","spelling","display_name","is_primary"]}}}}