Le mode sandbox de l’API EasyJobs est un environnement d’intégration isolé qui permet de simuler toutes les opérations d’envoi, modification et suppression d’offres d’emploi sans affecter la base de données de production. Il s’agit d’une version dédiée aux tests, conçue pour aider les intégrateurs à :
- développer leurs scripts de manière sécurisée,
- valider le format et la structure des requêtes,
- s’assurer du bon comportement de leur client HTTP,
- détecter les erreurs avant la mise en production.
Note : Les données créées dans le sandbox sont automatiquement supprimées chaque nuit pour garantir un environnement propre.
Nous recommandons vivement d’utiliser le mode sandbox pour tous vos tests techniques, validations internes, démonstrations ou intégrations initiales.
- Aucun impact sur les données visibles publiquement.
- Tolérance accrue aux erreurs.
- Logs dédiés pour un meilleur suivi des essais.
- Aucun risque de déclencher des publications non désirées.
Utiliser directement l’environnement de production pour les tests pourrait engendrer des incohérences, des publications accidentelles ou une saturation du système. Le mode sandbox est précisément là pour éviter ces situations.
Le mode sandbox se distingue uniquement par l’URL utilisée. Aucun paramètre ou header spécifique n’est nécessaire pour basculer entre les deux modes.
- Endpoint en production :
https://api.easyjobs.fr/v1/json/job-posting - Endpoint en sandbox :
https://api.easyjobs.fr/v1-sandbox/json/job-posting
Seule la racine de l’URL change : remplacez /v1/ par /v1-sandbox/. Tous les endpoints existants sont disponibles dans le sandbox (sauf indication contraire dans la documentation du endpoint).
Le système d’authentification reste exactement le même que pour le mode production :
- Authorization:
Bearer {API_TOKEN} - Usersecretkey:
{SECRET_KEY}
Les comptes API utilisés pour le sandbox sont les mêmes que ceux de production. Vous pouvez donc réutiliser vos identifiants pour tester vos requêtes.
L’interface interactive de test Swagger est également disponible pour l’environnement sandbox. Elle vous permet de :
- visualiser la structure des endpoints,
- tester vos requêtes sans écrire de code,
- obtenir des réponses simulées en direct.
Vous pouvez accéder à Swagger UI de l’API EasyJobs ici : https://api.easyjobs.fr/ui/swagger/.
N’oubliez pas de modifier l’environnement Postman en conséquence :
- base_url :
https://api.easyjobs.fr/v1-sandbox/ - api_token, secret_key, origin : identiques à l’environnement réel
Une collection dédiée au sandbox est disponible et structurée exactement comme celle de production.
- Validez la structure de vos objets JSON / XML dans le sandbox avant toute tentative en production.
- Utilisez le sandbox pour chaque modification majeure de vos scripts ou connecteurs ATS.
Une fois vos tests validés dans le mode sandbox :
- Mettez à jour l’URL vers l’environnement production.
- Testez une dernière fois avec des données réelles.
- Surveillez les logs de production en cas de souci.
Notre équipe reste à votre disposition pour vous assister dans la configuration de vos tests en mode sandbox. N'hésitez pas à nous contacter via support@easyjobs.fr.