Docs / API

Endpoints API

Liste complète des endpoints de l'API Maluro.

Base URL

https://api.maluro.com/api/v1

Prospects

Liste des prospects

GET /prospects

Paramètres de requête :

ParamètreTypeDescription
pagenumberNuméro de page (défaut: 1)
limitnumberRésultats par page (défaut: 20)
statusstringFiltrer par statut
searchstringRecherche textuelle

Créer un prospect

POST /prospects
Content-Type: application/json
{
  "name": "Jean Martin",
  "email": "jean.martin@email.com",
  "phone": "+33612345678",
  "type": "investor",
  "criteria": {
    "budget_min": 100000,
    "budget_max": 200000,
    "min_yield": 5.5
  }
}

Obtenir un prospect

GET /prospects/:id

Mettre à jour un prospect

PUT /prospects/:id

Supprimer un prospect

DELETE /prospects/:id

La suppression est irréversible. Utilisez plutôt l’archivage quand possible.

Biens

Liste des biens

GET /properties

Créer un bien

POST /properties
{
  "address": "12 rue Example, 69001 Lyon",
  "type": "apartment",
  "surface": 45,
  "price": 180000,
  "estimated_rent": 750
}

Transactions

Liste des transactions

GET /transactions

Créer une transaction

POST /transactions
{
  "prospect_id": "prs_123",
  "property_id": "prp_456",
  "offer_amount": 175000
}

Pagination

Toutes les listes supportent la pagination :

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

Utilisez limit avec parcimonie pour optimiser les performances.