- Étape 1 — Créez un nouvel environnement
- Étape 2 — Ajoutez les variables suivantes
- Étape 3 — Activez l’environnement
- Étape 4 — Vérifiez les en-têtes dans chaque requête
- Étape 5 — Exemples pour tester l’API
- Exemple 1 : Publier une offre (Job Posting JSON)
- Exemple 2 : Modifier une offre (Job Edit JSON)
- Exemple 3 : Supprimer une offre (Job Delete)
- Exemple 4 : Lister vos offres publiées (Jobs Listing)
- Paramètres de requête disponibles (Jobs Listing)
- Exemple : Publication d’une offre d’emploi via Postman
- Ressources téléchargeables
- Bonnes pratiques
- Ouvrez Postman.
- Cliquez sur l’icône ⚙️ en haut à droite → Environments.
- Cliquez sur Add ou Create a new environment.
- Donnez un nom à l’environnement, par exemple :
EasyJobs API - Sandbox.
Dans la section des variables, ajoutez les éléments suivants en respectant scrupuleusement la casse — les valeurs sont sensibles à la syntaxe exacte.
| Variable | Valeur exemple (à remplacer) | Description |
|---|---|---|
| API_TOKEN | eyJ1c2VyX2lkIjoiMTI4... | Votre token d’authentification Bearer. |
| SECRET_KEY | 8ba3e8dad85193323e72... | Votre clé secrète utilisateur. |
| ORIGIN | https://www.votre-domaine.com | Domaine autorisé (doit correspondre à celui inscrit dans votre tableau de bord API). |
| LANGUAGE | fr | Langue des réponses (valeurs acceptées : fr, en, es). |
Option alternative : importer un fichier d’environnement. Au lieu de saisir les variables manuellement, vous pouvez importer ce fichier prêt à l’emploi dans Postman :
{
"id": "e20fbd7e-d577-4b97-9a82-f4e7e9b83f1e",
"name": "easyjobs—sandbox",
"values": [
{
"key": "base_url",
"value": "https://api.easyjobs.fr/v1-sandbox",
"enabled": true
},
{
"key": "API_TOKEN",
"value": "eyJ1c2VyX2lkIjoiMTI4IiwidGltZXN0YW1wIjoxNzM2NzYwNjkwfQ==.e7d60477096b85dceac1895fc7bc4f24af7fa603b72a84ce6c826d98a1634d29",
"enabled": true
},
{
"key": "SECRET_KEY",
"value": "8ba3e8dad85193323e72e985d1831580198de00f5857c67980eaded34a0cabf5",
"enabled": true
},
{
"key": "ORIGIN",
"value": "https://www.infotech-pc.com",
"enabled": true
},
{
"key": "LANGUAGE",
"value": "fr",
"enabled": true
}
],
"timestamp": 1718535000000,
"_postman_variable_scope": "environment",
"_postman_exported_at": "2025-06-16T10:00:00.000Z",
"_postman_exported_using": "Postman/10.23.0"
}
Note : Vous pouvez importer ces variables manuellement ou télécharger directement le fichier d’environnement prêt à l’emploi en cliquant sur le bouton ci-dessous.
- Dans le coin supérieur droit de Postman, sélectionnez l’environnement
EasyJobs API - Sandbox. - Vérifiez que les variables sont bien prises en compte dans vos requêtes.
Les en-têtes nécessaires sont automatiquement ajoutés dans la collection fournie. Vous pouvez les vérifier ou les modifier si besoin :
Authorization: Bearer {{API_TOKEN}}
Usersecretkey: {{SECRET_KEY}}
Accept-Language: {{LANGUAGE}}
User-Agent: EasyJobsPostmanTest/1.0
Origin: {{ORIGIN}}
Content-Type: application/json
Voici quelques exemples concrets que vous pouvez exécuter directement dans Postman une fois votre environnement configuré. Ces exemples sont inclus dans la collection Postman officielle, mais vous pouvez également les dupliquer ou les adapter à vos propres besoins.
- Job Posting JSON — Envoyer une offre unique au format JSON vers l’endpoint
/v1-sandbox/json/job-posting. - Job Edit JSON — Modifier une offre existante avec
/v1-sandbox/json/job-edit(nécessite le champidet la nouvelledate). - Job Delete — Supprimer une offre avec l’ID via
/v1-sandbox/json/job-delete(nécessite le champid). - Jobs Listing — Récupérer la liste de vos offres publiées via
/v1-sandbox/jobs-listavec une requêteGET.
Contenu à envoyer dans l’onglet Body → raw → JSON :
Exemple 1 : Publier une offre (Job Posting JSON). Requête POST vers : https://api.easyjobs.fr/v1-sandbox/json/job-posting
{
"id": "4M0123456N43N25",
"date": "2025-04-22 10:00:00",
"valid_through": "2025-05-22 10:00:00",
"title": "Développeur Web Fullstack - H/F",
"contract_type": "CDI",
"work_hours": "35 heures",
"employment_type": "Freelance",
"description": "Nous recherchons un Développeur Web Fullstack, pour développer une application.",
"position": "Nous recherchons un(e) développeur(se) web fullstack passionné(e) pour rejoindre notre équipe dynamique. Vous participerez à la conception et au développement d'applications web innovantes pour des clients internationaux.",
"profile": "Vous avez une expérience de 3 ans minimum en PHP, JavaScript et frameworks modernes. Vous aimez travailler en équipe et relever de nouveaux défis.",
"location": "Paris",
"postcode": "75001",
"region": "Île-de-France",
"country": "France",
"subsidiary": "Agence Web",
"url": "https://www.exemple.com/offre",
"salary": "",
"salary_min": "27400€/an",
"salary_max": "32100€/an",
"rome": "M1805",
"available": "1",
"experience": "Expérience souhaitée",
"company_logo_url": "https://www.exemple.com/logo.png",
"posted_via": "My Company"
}
Exemple 2 : Modifier une offre (Job Edit JSON). Ce test permet de mettre à jour un ou plusieurs champs (ex. le titre et la description) d’une offre existante. Vous devez fournir au minimum les champs id et date. Requête PUT vers : https://api.easyjobs.fr/v1-sandbox/json/job-edit
{
"id": "4M0123456N43N25",
"date": "2025-04-26 09:00:00",
"title": "Développeur Fullstack expérimenté - H/F",
"description": "Mise à jour : nous recherchons toujours activement un développeur Fullstack expérimenté en React et Node.js pour renforcer notre équipe."
}
Exemple 3 : Supprimer une offre (Job Delete). Pour supprimer une offre, il suffit d’envoyer son identifiant unique dans le corps de la requête. Requête DELETE vers : https://api.easyjobs.fr/v1-sandbox/job-delete
{
"id": "4M0123456N43N25"
}
Exemple 4 : Lister vos offres publiées (Jobs Listing). Ce test ne nécessite pas de corps de requête. Il suffit d’exécuter une requête GET dans Postman avec les en-têtes requis. Requête GET vers : https://api.easyjobs.fr/v1-sandbox/jobs-list.
Vous pouvez également filtrer les résultats en ajoutant des paramètres dans l’URL. Par exemple : https://api.easyjobs.fr/v1-sandbox/jobs-list?limit=10&page=1. Si aucun paramètre n’est spécifié, la requête retourne toutes les offres associées à votre compte, paginées par blocs de 10 résultats. Vous pouvez ajuster la taille de chaque page jusqu’à un maximum de 50 éléments en utilisant le paramètre limit, et naviguer entre les pages avec page.
Si aucun paramètre n’est spécifié, la requête retourne les offres paginées par blocs de 10 résultats par défaut.
Paramètres de requête disponibles :
| Paramètre | Type | Valeur par défaut | Description |
|---|---|---|---|
page |
Entier | 1 | Numéro de page à afficher. Par défaut : 1. Doit être ≥ 1. |
limit |
Entier | 10 | Nombre maximum d’offres par page (maximum : 50, par défaut : 10). |
search |
Chaîne | — | Mot-clé ou expression à rechercher dans le titre ou la description des offres. |
location |
Chaîne | — | Filtrer par ville ou région. |
job_id |
Chaîne | — | Identifiant unique d’une offre, utilisé pour filtrer une offre précise. |
date_created |
Date | — | Filtrer les offres créées à une date spécifique (format YYYY-MM-DD). |
last_update |
Date | — | Filtrer selon la date de dernière mise à jour (format YYYY-MM-DD). |
Les valeurs sont sensibles à la casse — respectez la syntaxe exacte.
Ce scénario montre comment publier une offre d’emploi en utilisant directement la collection Postman fournie par EasyJobs. La requête utilise la méthode POST vers l’endpoint /v1-sandbox/json/job-posting, avec les en-têtes et le corps requis. Assurez-vous d’avoir configuré l’environnement avec les variables {{API_TOKEN}}, {{SECRET_KEY}}, {{LANGUAGE}} et {{ORIGIN}}.
Méthode : POST vers https://api.easyjobs.fr/v1-sandbox/json/job-posting
En-têtes requis :
Authorization: Bearer {{API_TOKEN}}
Usersecretkey: {{SECRET_KEY}}
Accept-Language: {{LANGUAGE}}
User-Agent: EasyJobsPostmanTest/1.0
Origin: {{ORIGIN}}
Content-Type: application/json
{
"info": {
"_postman_id": "3a6b066a-79fd-5de4-8016-da689041103a",
"name": "EasyJobs API – Job Posting JSON (Collection d’exemple)",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
},
"item": [
{
"name": "Job Posting JSON",
"request": {
"method": "POST",
"header": [
{
"key": "Authorization",
"value": "Bearer {{API_TOKEN}}"
},
{
"key": "Usersecretkey",
"value": "{{SECRET_KEY}}"
},
{
"key": "User-Agent",
"value": "PostmanRuntime/7.32.3"
},
{
"key": "Content-Type",
"value": "application/json"
},
{
"key": "Accept-Language",
"value": "{{LANGUAGE}}"
},
{
"key": "Origin",
"value": "{{ORIGIN}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"id\": \"4M0123456N43N25\",\n \"date\": \"2025-04-22 10:00:00\",\n \"valid_through\": \"2025-05-22 10:00:00\",\n \"title\": \"Développeur Web Fullstack - H/F\",\n \"contract_type\": \"CDI\",\n \"work_hours\": \"35 heures\",\n \"employment_type\": \"Freelance\",\n \"description\": \"Nous recherchons un Développeur Web Fullstack, pour développer une application.\",\n \"position\": \"Nous recherchons un(e) développeur(se) web fullstack passionné(e) pour rejoindre notre équipe dynamique. Vous participerez à la conception et au développement d'applications web innovantes pour des clients internationaux.\",\n \"profile\": \"Vous avez une expérience de 3 ans minimum en PHP, JavaScript et frameworks modernes. Vous aimez travailler en équipe et relever de nouveaux défis.\",\n \"location\": \"Paris\",\n \"postcode\": \"75001\",\n \"region\": \"Île-de-France\",\n \"country\": \"France\",\n \"subsidiary\": \"Agence Web\",\n \"url\": \"https://www.exemple.com/offre\",\n \"salary\": \"\",\n \"salary_min\": \"27400€/an\",\n \"salary_max\": \"32100€/an\",\n \"rome\": \"M1805\",\n \"available\": \"1\",\n \"experience\": \"Expérience souhaitée\",\n \"company_logo_url\": \"https://www.exemple.com/logo.png\",\n \"posted_via\": \"My Company\"\n}"
},
"url": {
"raw": "https://api.easyjobs.fr/v1-sandbox/json/job-posting",
"protocol": "https",
"host": [
"api",
"easyjobs",
"fr"
],
"path": [
"v1-sandbox",
"json",
"job-posting"
]
}
}
}
]
}
Note : Cette requête est déjà incluse dans la collection Postman téléchargeable. Vous pouvez la retrouver, prête à l’emploi, dans la page Téléchargements ou la télécharger directement à l’aide du bouton ci-dessous.
Une section dédiée est disponible pour vous permettre de télécharger tous les exemples JSON / XML, ainsi que la collection Postman officielle prête à l’emploi. Cela vous permet de gagner du temps et de tester l’API sans écrire manuellement chaque requête.
Accédez à la page : Téléchargements d’exemples
- Restez toujours dans l’environnement sandbox.
- Ne jamais exposer vos clés d’accès en public.
- Surveillez les quotas et les limites de retry pour éviter les blocages (code 429).
- Consultez régulièrement les logs pour détecter les erreurs inattendues ou récurrentes.