API REST
Pour utiliser l'API, il faut un compte CoinDuDoc. Aucune route n'est disponible sans compte, à part la connexion.
Elle est très utile pour automatiser vos recherches. Vous cherchez un travail ou un local à louer dans un département : votre programme interroge CoinDuDoc et récupère les annonces qui correspondent.
C'est aussi pratique pour ceux qui postent beaucoup d'annonces. L'API se branche directement dans votre code ou votre logiciel, et la publication s'automatise.
L'adresse de base est https://coindudoc.com/api/. Le détail des champs, les exemples et les erreurs sont dans Swagger.
Obtenir un jeton
Créez un compte et confirmez l'email. La connexion renvoie un jeton. Le mot de passe n'est pas conservé, et le jeton en clair n'est renvoyé qu'à ce moment-là.
curl -s https://coindudoc.com/api/auth/login \
-H 'Content-Type: application/json' \
-d '{"email":"[email protected]","password":"votre-mot-de-passe"}'
La réponse contient le jeton. Les appels suivants envoient
Authorization: Bearer suivi de ce jeton.
POST /api/auth/logout le révoque.
Dix tentatives de connexion sont autorisées par 15 minutes et par adresse IP. Au-delà, la réponse est 429.
Ce que l'API couvre
- Lister, créer, modifier et archiver des annonces.
- Ajouter, réordonner et supprimer leurs images. Le serveur les convertit en JPEG, au plus 2000 px.
- Lire les référentiels :
GET /api/categories,/api/professions,/api/departments,/api/countries. - Lire le compte connecté (
GET /api/me) et ses annonces actives. - Envoyer un message de contact.
Pour des raisons de confidentialité, les coordonnées des annonceurs ne sont pas disponibles dans l'API.