Documentation de l'API EasyJobs

Endpoints
Overview Authentification Gestion des erreurs
Sommaire
Présentation des endpoints

Les endpoints constituent les points d’entrée de l’API EasyJobs. Chacun permet d’effectuer une opération spécifique : publier, modifier, supprimer ou récupérer des offres d’emploi. Cette page détaille le fonctionnement, les méthodes, les formats, et les cas d’utilisation pour chaque endpoint.

Endpoints disponibles

Ce tableau regroupe l’ensemble des endpoints disponibles dans l’API EasyJobs, classés par type. Pour chaque action, vous trouverez : la méthode HTTP attendue, l’URL d’accès, une brève description, ainsi qu’un lien vers des exemples et la documentation complète.

À noter : l’endpoint /jobs-list est le seul à accepter des paramètres de requête dans l’URL (page, limit, search, etc.). Vous trouverez la liste complète de ces paramètres ainsi que des exemples d’utilisation dans la documentation dédiée à ce endpoint.

Endpoints JSON Méthode Description Langages Intégration URL
/jobs-posting POST Soumettre plusieurs offres en une seule requête Code Copier
/job-posting POST Soumettre une offre d'emploi Code Copier
/jobs-edit PUT Modifier plusieurs offres en une seule requête Code Copier
/job-edit PUT Modifier une offre d'emploi Code Copier
/jobs-delete DELETE Supprimer plusieurs offres par leurs identifiants Code Copier
Endpoints XML Méthode Description Langages Intégration URL
/jobs-posting POST Soumettre plusieurs offres en une seule requête Code Copier
/job-posting POST Soumettre une offre d'emploi Code Copier
/jobs-edit PUT Modifier plusieurs offres en une seule requête Code Copier
/job-edit PUT Modifier une offre d'emploi Code Copier
/jobs-delete DELETE Supprimer plusieurs offres par leurs identifiants Code Copier
Autres endpoints Méthode Description Langages Intégration URL
/jobs-list GET Obtenir la liste des offres publiées Code Copier
/job-delete DELETE Supprimer une offre par son identifiant Code Copier

Vous pouvez tester tous ces endpoints en important notre collection officielle Postman. Accédez à la page : Documentation Postman.

Structure générale d’un endpoint
  • Méthode HTTP (POST, GET, PUT, DELETE)
  • URL (chemin d’accès)
  • Headers obligatoires (Authorization, Usersecretkey...)
  • Body (format JSON/XML)
  • Réponses attendues

Structure typique :

                
                  [Méthode] https://api.easyjobs.fr/v1/[format]/[action]
Classification des endpoints
  • Publication
  • Modification
  • Suppression
  • Consultation
Exemples d’intégration en PHP, Python, C# et JavaScript par endpoint

Codes HTTP de réponse possibles (résumé)
Code HTTP Signification Quand cela se produit-il ?
400 Requête invalide Champ manquant, format incorrect, ou valeur incohérente.
401 Non authentifié Token ou clé secrète manquant(e) ou invalide.
403 Accès interdit Le domaine d’origine n’est pas autorisé.
404 Non trouvé L’endpoint n’existe pas ou l’ID envoyé est introuvable.
405 Méthode non autorisée Une méthode HTTP incorrecte a été utilisée.
500 Erreur serveur Problème interne côté API. Contacter le support si cela persiste.

Pour plus de détails et la liste complète des messages personnalisés, consultez la page : Codes et messages d’erreurs

Bonnes pratiques spécifiques aux endpoints

Bon à savoir : Toujours vérifier le code HTTP retourné par chaque endpoint pour traiter les erreurs efficacement. Implémentez des mécanismes de relance en cas de réponse 429 ou 500, et optimisez vos requêtes en envoyant plusieurs offres dans une même requête (batching) chaque fois que possible.

Limites et restrictions
  • Limite par IP : 100 requêtes par minute / 1000 requêtes par heure
  • Concurrence : 5 requêtes simultanées par utilisateur.
  • Timeout : 15 secondes par requête.
  • Taille maximale du payload : 3 Mo par requête POST / PUT.

Si ces limites sont dépassées, l’API retournera un code d’erreur approprié (voir Gestion des erreurs).

Pour plus d’informations sur les règles générales d’utilisation de l’API, consultez la page : Limites et restrictions

Cas d’usage avancés
  • Publication en masse automatisée : Utilisez /jobs-posting pour envoyer des lots d’offres depuis un système externe (ERP, ATS, etc). Voir exemple JSON / exemple XML.
  • Synchronisation bidirectionnelle : Après publication, utilisez /jobs-list pour vérifier l’import et la cohérence des données. Enchaînez avec /jobs-edit ou /jobs-delete selon les besoins.
  • Automatisation de la suppression : Planifiez des appels réguliers à /jobs-delete pour retirer les offres expirées ou pour synchroniser avec votre base de données locale.
  • Gestion des erreurs avancée : Consultez la page Gestion des erreurs pour adapter vos scripts aux codes et messages retournés.
  • Enchaînement sécurisé : Toujours vérifier le code de réponse de chaque appel avant de passer à l’étape suivante.
Téléchargements utiles

Téléchargez nos exemples complets (JSON / XML) ou la collection Postman prête à l’emploi : Télécharger les exemples | Collection Postman

Conditions Générales d'Utilisation
Copyright EasyJobs API © 2025 - Tous droits réservés