🛡️ Guildes

Guildes du réseau (NGuilds).

Adresse de base

https://api.nalyora.fr/v1 · lecture seule, sans clé, 10 requêtes par seconde.

Liste des guildes

GET/guildes

Paramètres

Nom	Dans	Type	Description
`q`	requête	string	Recherche dans le nom
`limite`	requête	integer · défaut 20
`decalage`	requête	integer · défaut 0	Nombre de résultats à sauter

Réponse

200 Guildes actives.

Champ	Type	Description
`total`	integer	Nombre total de résultats (avant pagination)
`guildes`	object[]	Guildes de la page
`guildes[].id`	integer (int64)	Identifiant numérique
`guildes[].nom`	string	Texte visible
`guildes[].nom_mini_message`	string	Nom avec sa mise en forme MiniMessage.
`guildes[].palier`	integer	Palier de la guilde, de 1 à 10
`guildes[].xp`	integer (int64)	Expérience totale
`guildes[].points_saison`	integer (int64)	Points de la saison en cours
`guildes[].banque`	number	Argent dans la banque de la guilde
`guildes[].membres`	integer	Nombre de membres
`guildes[].suspendue`	boolean	Vrai si l'entretien est impayé (home et bonus d'XP suspendus)
`guildes[].creee_le`	string (date-time)	Date de création

Exemple

{
  "total": 1,
  "guildes": [
    {
      "id": 2,
      "nom": "NalyoraDev",
      "nom_mini_message": "NalyoraDev",
      "palier": 1,
      "xp": 0,
      "points_saison": 0,
      "banque": 0,
      "membres": 1,
      "suspendue": false,
      "creee_le": "2026-11-02T18:48:26.979Z"
    }
  ]
}

curl "https://api.nalyora.fr/v1/guildes"

▶ Essayer

Détail d'une guilde

GET/guildes/{guilde}

Paramètres

Nom	Dans	Type	Description
`guilde` requis	chemin	string	Identifiant numérique ou nom sans mise en forme

Réponse

200 La guilde.

Champ	Type	Description
`id`	integer (int64)	Identifiant numérique
`nom`	string	Texte visible
`nom_mini_message`	string	Nom avec sa mise en forme MiniMessage.
`palier`	integer	Palier de la guilde, de 1 à 10
`xp`	integer (int64)	Expérience totale
`points_saison`	integer (int64)	Points de la saison en cours
`banque`	number	Argent dans la banque de la guilde
`membres`	integer	Nombre de membres
`suspendue`	boolean	Vrai si l'entretien est impayé (home et bonus d'XP suspendus)
`creee_le`	string (date-time)	Date de création

Erreurs possibles : 404 La ressource n'existe pas. Toutes les erreurs

Exemple

{
  "id": 2,
  "nom": "NalyoraDev",
  "nom_mini_message": "NalyoraDev",
  "palier": 1,
  "xp": 0,
  "points_saison": 0,
  "banque": 0,
  "membres": 1,
  "suspendue": false,
  "creee_le": "2026-11-02T18:48:26.979Z"
}

curl "https://api.nalyora.fr/v1/guildes/NalyoraDev"

▶ Essayer

Membres d'une guilde

GET/guildes/{guilde}/membres

Paramètres

Nom	Dans	Type	Description
`guilde` requis	chemin	string	Identifiant numérique ou nom sans mise en forme

Réponse

200 Membres, du rang le plus haut au plus bas.

Champ	Type	Description
`total`	integer	Nombre total de résultats (avant pagination)
`membres`	object[]	Nombre de membres
`membres[].uuid`	string (uuid)	UUID Minecraft
`membres[].pseudo`	string	Pseudo Minecraft
`membres[].role`	chef \| officier \| membre \| recrue	Rang dans la guilde : chef, officier, membre ou recrue
`membres[].contribution_saison`	integer (int64)	Contribution du membre à la saison
`membres[].rejoint_le`	string (date-time)	Date d'arrivée dans la guilde

Erreurs possibles : 404 La ressource n'existe pas. Toutes les erreurs

Exemple

{
  "total": 1,
  "membres": [
    {
      "uuid": "4ece5b9d-2916-341c-8fe3-7428bcc0ef23",
      "pseudo": "NotKoda_",
      "role": "chef",
      "contribution_saison": 0,
      "rejoint_le": "2026-11-02T18:48:26.979Z"
    }
  ]
}

curl "https://api.nalyora.fr/v1/guildes/NalyoraDev/membres"

▶ Essayer