Connexion ou Inscription
Aide Suivi ❤️ Favoris ⭐
💰 Cours
🥈66€▲0.0%
🥇3 790€▲0.0%

🔌 API Publique Elnumis

Accédez aux données numismatiques d'Elnumis via notre API REST

URL de base : https://elnumis.fr/api/v1

📖 Introduction

L'API Elnumis permet d'accéder aux annonces, au catalogue de référence et aux catégories. Toutes les réponses sont en JSON.

Authentification

L'API publique ne nécessite pas d'authentification. Certaines limites de taux s'appliquent (100 requêtes/minute par IP).

Format des réponses

{
  "data": [...],
  "meta": {
    "total": 150,
    "page": 1,
    "limit": 20,
    "pages": 8
  }
}

📡 Endpoints

GET /products

Liste des produits en vente

Paramètres

page Page (défaut: 1)
limit Résultats par page (max: 50, défaut: 20)
category ID de catégorie
sale_type auction | fixed | offer
min_price Prix minimum
max_price Prix maximum
sort newest | price_asc | price_desc | popular

Exemple

GET /api/v1/products?category=1&limit=10&sort=price_desc
GET /products/{id}

Détail d'un produit

Réponse

{
  "data": {
    "id": 123,
    "title": "20 Francs Napoléon III 1869",
    "description": "...",
    "sale_type": "fixed",
    "price": 350.00,
    "condition": "SUP",
    "year": "1869",
    "mint": "Paris (A)",
    "metal": "Or",
    "weight": 6.45,
    "category": "Monnaies françaises Or",
    "seller": {"id": 5, "username": "numis_expert"},
    "images": ["https://..."],
    "url": "https://..."
  }
}
GET /categories

Liste des catégories

Réponse

{
  "data": [
    {
      "id": 1,
      "name": "Monnaies françaises Or",
      "slug": "monnaies-francaises-or",
      "icon": "🥇",
      "product_count": 45
    },
    ...
  ]
}
GET /search

Recherche de produits

Paramètres

q Terme de recherche (min 2 caractères)
page Page (défaut: 1)
limit Résultats par page (défaut: 20)

Exemple

GET /api/v1/search?q=napoleon&limit=5
GET /catalog

Catalogue de référence avec cotes

Réponse

{
  "data": [
    {
      "id": 1,
      "name": "20 Francs Napoléon III",
      "year": "1869",
      "mint": "Paris (A)",
      "metal": "Or",
      "weight": 6.45,
      "mintage": "5,234,000",
      "rarity": "C",
      "prices": {
        "VG": 280,
        "F": 300,
        "VF": 320,
        "XF": 350,
        "AU": 400,
        "UNC": 500
      }
    }
  ]
}

⚠️ Codes d'erreur

400 Requête invalide
404 Ressource non trouvée
429 Trop de requêtes (rate limit)
500 Erreur serveur

💻 Exemples

cURL

curl -X GET "https://elnumis.fr/api/v1/products?limit=5"

JavaScript (Fetch)

fetch('https://elnumis.fr/api/v1/products?limit=5')
  .then(res => res.json())
  .then(data => console.log(data));

Python

import requests
response = requests.get('https://elnumis.fr/api/v1/products', params={'limit': 5})
data = response.json()
print(data)