Vos mandats, sans double saisie.

Documentation

L’API en quelques minutes.

API REST, réponses JSON, authentification par clé. Les accès sont ouverts au cas par cas : écrivez-nous et nous vous transmettons votre clé ainsi que l’identifiant de votre compte agence.

Authentification

Chaque requête porte votre clé dans l’en-tête Authorization. Une clé donne accès à la lecture du catalogue (read) et, si vous en avez besoin, au dépôt de mandats (write).

curl https://supabase-lr.oomnius.fr/functions/v1/api/v1/listings \
  -H "Authorization: Bearer lr_live_votre_cle"

Traitez cette clé comme un mot de passe : elle ne doit jamais figurer dans du code exécuté par un navigateur. En cas de doute, demandez-nous sa révocation — elle est immédiate.

Points d’entrée

Méthode	Chemin	Description
GET	/v1/listings	Catalogue des annonces publiées — filtres et pagination.
GET	/v1/listings/:id	Détail d’une annonce.
GET	/v1/me/listings	Vos mandats et leur statut de validation.
POST	/v1/listings	Déposer un mandat (créé en brouillon).
PATCH	/v1/listings/:id	Mettre à jour un brouillon.

Filtres de recherche

Paramètre	Description
sector	Secteur d’activité
region	Région
department	Département (numéro)
price_min / price_max	Fourchette de prix de cession
revenue_min	Chiffre d’affaires minimum
limit / offset	Pagination (25 par défaut, 100 maximum)

Déposer un mandat

Un dépôt crée un brouillon : la mise en ligne reste soumise à la validation de notre équipe, et au règlement de la publication si l’annonce offerte du compte est déjà utilisée. Ce sont les mêmes règles que sur le site.

curl -X POST https://supabase-lr.oomnius.fr/functions/v1/api/v1/listings \
  -H "Authorization: Bearer lr_live_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Boulangerie-pâtisserie, centre-ville de Lyon",
    "sector": "commerce",
    "region": "auvergne-rhone-alpes",
    "department": "69",
    "city": "Lyon",
    "price_eur": 320000,
    "revenue_eur": 480000,
    "ebitda_eur": 95000,
    "employees": 4,
    "description": "Affaire familiale tenue depuis 18 ans, clientèle fidèle…"
  }'

Réponses

Les données utiles sont toujours sous data, la pagination sous pagination. Une erreur renvoie un objet error avec un code lisible et un message en français.

{
  "error": {
    "code": "validation_failed",
    "message": "Certains champs sont invalides.",
    "details": ["`price_eur` doit être un entier positif."]
  }
}

Code	Signification
401 unauthorized	Clé absente, invalide ou révoquée.
403 forbidden	La clé n’a pas le droit demandé (read / write).
404 not_found	Annonce inexistante, ou non publiée et hors de votre compte.
409 not_editable	L’annonce est en ligne : sa modification passe par votre espace.
422 validation_failed	Champs manquants ou invalides (détaillés dans details).

À savoir

• Les montants sont en euros entiers, sans décimale ni séparateur.
• Le catalogue ne renvoie que les annonces publiées et visibles ; vos brouillons apparaissent via /v1/me/listings.
• Aucune donnée nominative de cédant ou de repreneur ne transite par l’API.
• La version v1 est stable : tout changement incompatible passera par une v2.