API REST

API REST publique

meepleo expose une API REST complète permettant aux développeurs d'intégrer la marketplace dans leurs propres applications (apps mobiles, scripts, intégrations tierces).

Démarrage rapide

1. Connectez-vous à votre compte
2. Allez sur Mes tokens API
3. Créez un token avec les permissions souhaitées
4. Utilisez-le dans le header Authorization: Bearer ... de vos requêtes

Documentation complète

La documentation détaillée des endpoints, paramètres, codes d'erreur et exemples curl est disponible dans le fichier API.md à la racine du dépôt.

Versioning

Version actuelle : v1. Toutes les routes sont préfixées par /api/v1/.

Format

Réponses JSON. Toutes les réponses suivent le format { success, data, meta?, error? }.

Permissions disponibles

• read — Lecture seule (annonces, profils publics)
• listings:write — Créer/modifier ses annonces
• orders:read — Voir ses transactions
• orders:write — Acheter, confirmer réception, expédier
• messages:read et messages:write — Messagerie
• account:write — Modifier son profil, alertes

Gérer mes tokens →