API Base Permanente des Equipements

Demarrage rapide

1 Authentification

Connectez-vous avec vos identifiants pour obtenir un token Bearer.

2 Token Bearer

Incluez le token dans l'en-tete Authorization de vos requetes.

3 Requetes API

Interrogez les equipements avec filtres, pagination et recherche geographique.

# 1. Connexion
curl -X POST https://bpe.carex.immo/api/v1/login \
  -H "Content-Type: application/json" \
  -d '{"email": "votre@email.com", "password": "votre_mot_de_passe"}'

# 2. Requete avec token
curl "https://bpe.carex.immo/api/v1/equipements?dep=75&per_page=10" \
  -H "Authorization: Bearer VOTRE_TOKEN"

Endpoints disponibles

Authentification

POST /api/v1/login Obtenir un token d'authentification

POST /api/v1/logout Auth Revoquer le token actuel

GET /api/v1/user Auth Informations de l'utilisateur connecte

Equipements

GET /api/v1/equipements Auth Liste paginee des equipements avec filtres

GET /api/v1/equipements/{id} Auth Detail d'un equipement

GET /api/v1/equipements/stats Auth Statistiques agregees

GET /api/v1/equipements/filters Auth Valeurs disponibles pour les filtres

Parametres de filtrage

Parametre	Description	Exemple
`dep`	Code departement	75, 971
`depcom`	Code commune INSEE	75056
`typequ`	Type d'equipement	A101, F103
`dom`	Domaine (A a G)	A (services), F (sport)
`search`	Recherche textuelle	ecole
`lat, lng, radius`	Recherche geographique (km)	lat=48.8566&lng=2.3522&radius=5
`per_page`	Resultats par page (max 100)	25

Domaines d'equipements

Services aux particuliers

Banques, postes, garages...

Commerce

Supermarches, boulangeries...

Enseignement

Ecoles, colleges, lycees...

Sante

Hopitaux, medecins, pharmacies...

Transports

Gares, aeroports, ports...

Sports et loisirs

Stades, piscines, cinemas...

Tourisme

Hotels, campings, offices...

Exemple de reponse

{
  "data": [
    {
      "id": 1,
      "typequ": "C101",
      "dom": "C",
      "localisation": {
        "dep": "75",
        "depcom": "75056",
        "latitude": 48.8566,
        "longitude": 2.3522
      },
      ...
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 15,
    "total": 2800000
  }
}