FernandoJVideira/RPG_Utilities
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Name Generator Rework

Browse Source
This commit is contained in:
FernandoJVideira
2025-08-01 01:13:33 +01:00
parent af9e88c580
commit 6075472f3d
3 changed files with 812 additions and 317 deletions
Download Patch File Download Diff File Expand all files Collapse all files
API.md
+96
View File
@@ -0,0 +1,96 @@
# NameGen API Documentation
## Base URL
```
https://namegen.fernandovideira.com/v1
```
## Fantasy Name Endpoints
| Race/Type | Endpoint | Query Parameters |
| ------------ | --------------------------- | ---------------- | ------ | ------- |
| Elf | /fantasy/elf-names | gender=male | female | child |
| Dwarf | /fantasy/dwarf-names | gender=male | female |
| Arakocra | /fantasy/arakocra-names | - |
| Aasimar | /fantasy/aasimar-names | gender=male | female |
| Bugbear | /fantasy/bugbear-names | - |
| Centaur | /fantasy/centaur-names | gender=male | female |
| Changeling | /fantasy/changeling-names | - |
| Deep Gnome | /fantasy/deep-gnome-names | gender=male | female |
| Deva | /fantasy/deva-names | gender=male | female |
| Dragonborn | /fantasy/dragonborn-names | gender=male | female | surname |
| Drow | /fantasy/drow-names | gender=male | female | surname |
| Duergar | /fantasy/duergar-names | gender=male | female |
| Eladrin | /fantasy/eladrin-names | gender=male | female |
| Fairy | /fantasy/fairy-names | gender=male | female |
| Firbolg | /fantasy/firbolg-names | gender=male | female | child |
| Genasi | /fantasy/genasi-names | - |
| Githyanki | /fantasy/githyanki-names | gender=male | female |
| Githzerai | /fantasy/githzerai-names | gender=male | female |
| Gnome | /fantasy/gnome-names | gender=male | female |
| Goblin | /fantasy/goblin-names | gender=male | female |
| Goliath | /fantasy/goliath-names | gender=male | female |
| Grung | /fantasy/grung-names | - |
| Half-Elf | /fantasy/half-elf-names | gender=male | female |
| Half-Orc | /fantasy/half-orc-names | gender=male | female |
| Halfling | /fantasy/halfling-names | gender=male | female |
| Harengon | /fantasy/harengon-names | gender=male | female |
| Hobgoblin | /fantasy/hobgoblin-names | - |
| Human | /fantasy/human-names | gender=male | female |
| Kalashtar | /fantasy/kalashtar-names | - |
| Kenku | /fantasy/kenku-names | - |
| Kobold | /fantasy/kobold-names | - |
| Leonin | /fantasy/leonin-names | gender=male | female |
| Lizardfolk | /fantasy/lizardfolk-names | gender=male | female |
| Locathah | /fantasy/locathah-names | - |
| Loxodon | /fantasy/loxodon-names | gender=male | female |
| Minotaur | /fantasy/minotaur-names | gender=male | female |
| Orc | /fantasy/orc-names | gender=male | female |
| Satyr | /fantasy/satyr-names | gender=male | female | child |
| Shadar-Kai | /fantasy/shadar-kai-names | gender=male | female |
| Shardmind | /fantasy/shardmind-names | - |
| Shifter | /fantasy/shifter-names | gender=male | female |
| Simic Hybrid | /fantasy/simic-hybrid-names | gender=male | female |
| Tabaxi | /fantasy/tabaxi-names | gender=male | female |
| Tiefling | /fantasy/tiefling-names | gender=male | female | virtue |
| Tortle | /fantasy/tortle-names | - |
| Triton | /fantasy/triton-names | gender=male | female |
| Vedalken | /fantasy/vedalken-names | gender=male | female |
| Verdan | /fantasy/verdan-names | - |
| Warforged | /fantasy/warforged-names | - |
| Wilden | /fantasy/wilden-names | gender=male | female |
| Yuan-Ti | /fantasy/yuan-ti-names | - |
## Modern Name Endpoints
| Language/Type | Endpoint | Query Parameters |
| ---------------------- | ------------------ | ---------------- | ------ | ------ |
| Modern English | /modern/english | gender=male | female | unisex |
| Modern Portuguese (EU) | /modern/portuguese | gender=male | female | unisex |
## How to Query the API
- All endpoints return a JSON object with a `names` array.
- Use the `gender` query parameter where supported (e.g., `?gender=female`).
- Example request:
```
GET https://namegen.fernandovideira.com/v1/fantasy/elf-names?gender=female
```
```
GET https://namegen.fernandovideira.com/v1/modern/english?gender=unisex
```
## Example Response
```json
{
"names": [
"Aelene Galanodel",
"Lia Siannodel",
...
]
}
```