🔨 Hôtel des ventes

Annonces en cours (NalyoraAuction).

Adresse de base

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

Annonces en cours

GET/encheres

Annonces actives de l'hôtel des ventes. La recherche ignore les accents.

Paramètres

Nom	Dans	Type	Description
`q`	requête	string	Objet recherché
`vendeur`	requête	string	Pseudo du vendeur
`prix_min`	requête	number
`prix_max`	requête	number
`tri`	requête	recent \| prix_asc \| prix_desc \| expiration · défaut recent
`limite`	requête	integer · défaut 20
`decalage`	requête	integer · défaut 0	Nombre de résultats à sauter

Réponse

200 Page d'annonces.

Champ	Type	Description
`total`	integer	Nombre total de résultats (avant pagination)
`annonces`	object[]	Annonces de la page
`annonces[].id`	integer (int64)	Identifiant numérique
`annonces[].objet`	string	Nom de l'objet en français.
`annonces[].prix`	number	Prix demandé
`annonces[].vendeur`	object	Vendeur de l'annonce
`annonces[].vendeur.uuid`	string (uuid)	UUID Minecraft
`annonces[].vendeur.pseudo`	string	Pseudo Minecraft
`annonces[].creee_le`	string (date-time)	Date de création
`annonces[].expire_le`	string (date-time)	Date de fin de l'annonce

Erreurs possibles : 400 Paramètre invalide. Toutes les erreurs

Exemple

{
  "total": 0,
  "annonces": [
    {
      "id": 0,
      "objet": "texte",
      "prix": 0,
      "vendeur": {
        "uuid": "fe315713-2634-335c-aa1b-cb2672898020",
        "pseudo": "texte"
      },
      "creee_le": "2026-11-05T02:24:13Z",
      "expire_le": "2026-11-05T02:24:13Z"
    }
  ]
}

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

▶ Essayer

Détail d'une annonce

GET/encheres/{id}

Paramètres

Nom	Dans	Type	Description
`id` requis	chemin	integer (int64)

Réponse

200 L'annonce.

Champ	Type	Description
`id`	integer (int64)	Identifiant numérique
`objet`	string	Nom de l'objet en français.
`prix`	number	Prix demandé
`vendeur`	object	Vendeur de l'annonce
`vendeur.uuid`	string (uuid)	UUID Minecraft
`vendeur.pseudo`	string	Pseudo Minecraft
`creee_le`	string (date-time)	Date de création
`expire_le`	string (date-time)	Date de fin de l'annonce

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

Exemple

{
  "id": 0,
  "objet": "texte",
  "prix": 0,
  "vendeur": {
    "uuid": "fe315713-2634-335c-aa1b-cb2672898020",
    "pseudo": "texte"
  },
  "creee_le": "2026-11-05T02:24:13Z",
  "expire_le": "2026-11-05T02:24:13Z"
}

curl "https://api.nalyora.fr/v1/encheres/128"

▶ Essayer

Statistiques de l'hôtel des ventes

GET/encheres/statistiques

Réponse

200 Chiffres globaux.

Champ	Type	Description
`annonces_actives`	integer	Nombre d'annonces en cours
`vendeurs`	integer	Nombre de vendeurs distincts
`prix_moyen`	number	Prix moyen des annonces actives

Exemple

{
  "annonces_actives": 0,
  "vendeurs": 0,
  "prix_moyen": 0
}

curl "https://api.nalyora.fr/v1/encheres/statistiques"

▶ Essayer