Référence API complète
Cette page présente l'ensemble des points d'accès de l'API Kourtier,
organisés par module.
Base URL
http://localhost:3000 (environnement local)
https://api.kourtier.com (environnement de production)
Authentification
La plupart des endpoints nécessitent une authentification. Incluez un
token JWT dans l'en-tête de votre requête :
Authorization: Bearer {votre_token_jwt}
Propriétés
|
Méthode
|
Endpoint
|
Description
|
| GET |
/properties |
Liste des propriétés
|
| GET |
/properties/:id
|
Détails d'une propriété
|
| POST |
/properties |
Créer une propriété
|
| PATCH |
/properties/:id
|
Modifier une propriété
|
| DELETE |
/properties/:id
|
Supprimer une propriété
|
Utilisateurs
|
Méthode
|
Endpoint
|
Description
|
| GET |
/users |
Liste des utilisateurs
|
| GET |
/users/:id |
Détails d'un utilisateur
|
| POST |
/users/register
|
Créer un compte
|
| POST |
/users/login |
Connexion |
| PATCH |
/users/:id |
Modifier un utilisateur
|
| DELETE |
/users/:id |
Supprimer un compte
|
Rendez-vous
|
Méthode
|
Endpoint
|
Description
|
| GET |
/appointments |
Liste des rendez-vous
|
| GET |
/appointments/:id
|
Détails d'un rendez-vous
|
| POST |
/appointments |
Créer un rendez-vous
|
| PATCH |
/appointments/:id
|
Modifier un rendez-vous
|
| DELETE |
/appointments/:id
|
Supprimer un rendez-vous
|
Favoris
|
Méthode
|
Endpoint
|
Description
|
| GET |
/favorites |
Liste des favoris
|
| POST |
/favorites |
Ajouter un favori
|
| DELETE |
/favorites/:id |
Supprimer un favori par ID
|
| DELETE |
/favorites |
Supprimer un favori par propertyId et userId
|
Notifications
|
Méthode
|
Endpoint
|
Description
|
| GET |
/notifications |
Liste des notifications
|
| POST |
/notifications |
Créer une notification
|
| PATCH |
/notifications/:id
|
Modifier une notification
|
| DELETE |
/notifications/:id
|
Supprimer une notification
|
Médias
|
Méthode
|
Endpoint
|
Description
|
| GET |
/images |
Liste des images
|
| POST |
/images/upload |
Télécharger une image
|
| DELETE |
/images/:id |
Supprimer une image
|
| GET |
/videos |
Liste des vidéos
|
| POST |
/videos/upload |
Télécharger une vidéo
|
| DELETE |
/videos/:id |
Supprimer une vidéo
|
Codes de statut HTTP
- 200 OK : Requête réussie
- 201 Created : Ressource créée avec succès
-
400 Bad Request : Requête incorrecte ou invalide
- 401 Unauthorized : Authentification requise
- 403 Forbidden : Accès refusé
- 404 Not Found : Ressource non trouvée
- 500 Internal Server Error : Erreur serveur