TomeUn

API Developers

L'API e-commerce pour la BD, le Manga et les Comics d'occasion. +100 000 references indexees.

v0.1.0 — Tous les systemes sont operationnels
Base URL
/api/v1
50+
Endpoints
10
Modules
100k+
References
REST
Architecture

Endpoints

Catalogue & Produits 10 endpoints
GET/productsListe paginee
GET/products/{slug}Detail produit
GET/products/isbn/{isbn}Recherche ISBN
GET/categoriesArbre des categories
GET/categories/{slug}Produits par categorie
GET/seriesListe des series
GET/series/{slug}Detail serie
GET/authors/{slug}Fiche auteur
GET/publishers/{slug}Fiche editeur
GET/nouveautesDernieres sorties
Recherche 2 endpoints
GET/searchRecherche full-text
GET/search/suggestAuto-completion
Authentification 14 endpoints
POST/auth/registerCreer un compte
POST/auth/loginConnexion
POST/auth/googleLogin Google
POST/auth/refreshRenouveler le token
POST/auth/logoutDeconnexion
GET/auth/meProfil utilisateur
PUT/auth/profileModifier le profil
DELETE/auth/meSupprimer le compte
POST/auth/forgot-passwordMot de passe oublie
POST/auth/reset-passwordReset du mot de passe
POST/auth/verify-emailVerifier l'email
GET/auth/addressAdresse de livraison
PUT/auth/addressModifier l'adresse
GET/auth/ordersHistorique commandes
Commandes & Paiements 4 endpoints
POST/payments/create-intentPaiement Stripe
POST/payments/webhookWebhook Stripe
POST/orders/claimReclamer une commande
POST/orders/confirmConfirmer une commande
Espace Vendeur 12 endpoints
POST/seller/listingsCreer une annonce
GET/seller/stockGestion du stock
PATCH/seller/stock/{sku_id}Modifier un article
DELETE/seller/stock/{sku_id}Retirer du stock
GET/seller/onboardingStatut onboarding
PUT/seller/shopConfig boutique
GET/seller/ordersCommandes vendeur
GET/seller/orders/{order_number}Detail commande
PATCH/seller/orders/{order_number}Mettre a jour
GET/seller/orders/pickingFile de picking
PATCH/seller/orders/picking/{item_id}Marquer picke
GET/seller/orders/carriersTransporteurs
Scan & Upload 7 endpoints
POST/scan-jobsUpload de scans
GET/scan-jobsListe des scans
GET/scan-jobs/{id}Detail d'un scan
PATCH/scan-jobs/{id}Modifier un scan
POST/scan-jobs/{id}/publishPublier
POST/scan-jobs/publish-batchPublication en lot
DELETE/scan-jobs/{id}Supprimer
Equipe 6 endpoints
GET/team/membersMembres de l'equipe
POST/team/inviteInviter un membre
GET/team/invitationsInvitations en attente
POST/team/accept/{token}Accepter invitation
PATCH/team/members/{member_id}Modifier un membre
DELETE/team/members/{member_id}Retirer un membre

Authentification

Quick Start

L'API utilise des JWT Bearer tokens. Connectez-vous pour obtenir un access token, puis incluez-le dans le header Authorization de chaque requete.

# 1. Connexion curl -X POST /api/v1/auth/login \ -H "Content-Type: application/json" \ -d '{"email": "dev@example.com", "password": "..."}' # 2. Utiliser le token curl /api/v1/products \ -H "Authorization: Bearer <access_token>"

Permissions

Les endpoints publics (produits, recherche, categories) ne requierent pas d'authentification. Les endpoints vendeur et team necessitent un token avec les permissions adequates.