- Description et paramètres de l’endpoint
- Mode Sandbox : pour tester en toute sécurité
- Champs obligatoires
- Exemple d’une suppression multiple (JSON brut)
- Réponse attendue
- Tester avec cURL
- Tester avec Postman
- Informations d’authentification requises
- En-têtes HTTP requis
- Exemple complet : modification d’une offre d’emploi via DELETE [PHP / JSON] (avec cURL)
- Exemple complet : modification d’une offre d’emploi via DELETE [Python / JSON] (avec requests)
- Exemple complet : modification d’une offre d’emploi via DELETE [C# / JSON]
- Exemple complet : modification d’une offre d’emploi via DELETE [JavaScript / JSON] (avec Node.js)
- Codes HTTP de réponse possibles
- Messages d’erreur possibles
L’endpoint jobs-delete JSON (https://api.easyjobs.fr/v1/json/jobs-delete) permet de supprimer plusieurs offres d’emploi en une seule requête DELETE. Le corps de la requête doit contenir un objet JSON avec une clé jobs, contenant un tableau d’objets job. Chaque objet doit spécifier un identifiant id valide. Le contenu doit être encodé en application/json. En retour, l’API fournit un rapport détaillé pour chaque offre :
200 OKsi l’offre a été supprimée avec succès.400 Bad Requestsi un identifiant est manquant, vide ou mal formaté.401 Unauthorizedsi le jeton d’authentification est manquant ou invalide.403 Forbiddensi la clé secrète est absente, si l’origine n’est pas autorisée.404 Not Foundsi l’offre spécifiée n’existe pas ou ne vous appartient pas.405 Method Not Allowedsi vous utilisez une méthode autre que DELETE.500 Internal Server Erroren cas d’erreur inattendue côté serveur.
Pour supprimer une seule offre, utilisez plutôt l’endpoint job-delete.
Tous les exemples ci-dessous sont conçus pour fonctionner en mode sandbox, afin de vous permettre de tester l’API EasyJobs sans impact réel. Pour passer en mode production, il suffit de remplacer v1-sandbox par v1 dans l’URL. Il est fortement recommandé de réaliser tous vos tests en mode sandbox avant d’utiliser l’environnement réel.
Pour en savoir plus sur le fonctionnement du mode sandbox, les environnements disponibles et les bonnes pratiques de test, consultez la page dédiée : Mode Sandbox de l'API EasyJobs.
Pour supprimer plusieurs offres d’emploi, un seul champ est strictement obligatoire :
id: Identifiant unique de chaque offre d’emploi à supprimer.
Ce champ doit respecter le format attendu (chaîne alphanumérique de 4 à 128 caractères, sans espaces ni symboles spéciaux). L’offre identifiée par cet ID doit exister et être associée à votre compte API.
Pour les requêtes en bulk (multi-suppression), chaque objet job du tableau JSON doit contenir un identifiant distinct. Aucune autre information n’est nécessaire.
Consultez la documentation complète des champs pour en savoir plus sur le format du champ id.
{
"jobs": {
"job": [
{
"id": "4M0123456N43N25"
},
{
"id": "4M0123456N43N26"
}
]
}
}
Cet exemple illustre la suppression de plusieurs offres d’emploi en une seule requête. Chaque objet job doit contenir un identifiant valide. Aucun autre champ n’est requis.
Important : Pour que la suppression soit effective, chaque offre doit être identifiée par un champ id valide, existant et associé à votre compte API. Toute requête contenant un identifiant incorrect ou manquant sera ignorée ou rejetée.
{
"status": "Offres d'emploi en file d'attente pour le traitement.",
"processed_jobs": 2,
"results": [
{
"job_id": "4M0123456N43N25",
"status": "success",
"message": "L'offre d'emploi 4M0123456N43N25 est en file d'attente pour le traitement."
},
{
"job_id": "4M0123456N43N26",
"status": "success",
"message": "L'offre d'emploi 4M0123456N43N26 est en file d'attente pour le traitement."
}
]
}
En cas d’erreur, consultez la page Gestion des erreurs.
curl -X DELETE https://api.easyjobs.fr/v1/json/jobs-delete \
-H "Authorization: Bearer <API_TOKEN>" \
-H "Usersecretkey: <SECRET_KEY>" \
-H "Content-Type: application/json" \
-H "Accept-Language: fr" \
-H "User-Agent: EasyJobsClient/1.0" \
-H "X-Client-Lang: <LANGAGE_CLIENT>" \
-H "Origin: https://www.domaine-origine.com" \
-d @suppression-multiple.json
Assurez-vous que le fichier suppression-multiple.json contient le JSON brut montré ci-dessus.
- Méthode :
DELETE - URL :
https://api.easyjobs.fr/v1/json/jobs-delete - En-têtes requis :
- Authorization:
Bearer <API_TOKEN> - Usersecretkey:
<SECRET_KEY> - Content-Type:
application/json - Accept-Language:
fr - User-Agent:
EasyJobsClient/1.0 - X-Client-Lang:
<LANGAGE_CLIENT> - Origin:
https://www.domaine-origine.com
- Authorization:
- Corps (Body) : sélectionner
raw, choisirJSON, et coller le contenu de l’exemple JSON brut (voir section "Exemple d’une suppression multiple (JSON brut)").
Pour exécuter correctement vos requêtes, veillez à remplacer les valeurs par défaut par vos propres informations d’authentification :
- API_TOKEN : votre jeton d’authentification personnel, disponible dans le dashboard EasyJobs API, rubrique "Gestion des clés".
- SECRET_KEY : votre clé secrète utilisateur, accessible également dans la rubrique "Gestion des clés".
Ces informations sont obligatoires pour autoriser l’accès à l’API et assurer l’authentification de vos requêtes.
Pour que vos requêtes soient correctement interprétées par l’API, les en-têtes suivants sont obligatoires :
Authorization: jeton d’authentification personnel (Bearer API_TOKEN).Usersecretkey: votre clé secrète utilisateur.Content-Type:application/json.Accept-Language: définit la langue de la réponse (valeurs possibles :fr,en,es).User-Agent: identifiant de votre client (ex. :EasyJobsClient/1.0). Obligatoire pour des raisons de sécurité.X-Client-Lang: nom de la technologie utilisée (ex. :PHP,Python,JavaScript,C#), utile pour le formatage des réponses.Origin: URL d’origine de la requête, qui doit être autorisée dans la section « Domaines autorisés » du dashboard.
// URL de l’endpoint API (mode sandbox)
$endpoint = "https://api.easyjobs.fr/v1-sandbox/json/jobs-delete";
// Authentification
$apiToken = "API_TOKEN"; // Token d’authentification Bearer
$secretKey = "SECRET_KEY"; // Clé secrète utilisateur
// Construction du payload JSON
$data = [
"jobs" => [
"job" => [
[ "id" => "4M0123456N43N25" ],
[ "id" => "4M0123456N43N26" ]
]
]
];
$jsonData = json_encode($data, JSON_UNESCAPED_UNICODE);
// Initialisation de la requête DELETE
$ch = curl_init($endpoint);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer $apiToken", // Token d’authentification
"Usersecretkey: $secretKey", // Clé secrète utilisateur
"Content-Type: application/json", // Format JSON
"Accept-Language: fr", // Langue de la réponse (valeurs possibles : en, fr, es)
"User-Agent: EasyJobsClient/1.0", // Identifiant de l’application appelante (nom + version)
"X-Client-Lang: PHP", // Indique au serveur la technologie cliente
"Origin: https://www.domaine-origine.com", // Remplacez par l’URL depuis laquelle vous appelez l’API
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonData);
$response = curl_exec($ch);
// Affichage de la réponse API
if (curl_errno($ch)) {
echo "Erreur cURL : " . curl_error($ch);
} else {
echo "Réponse de l’API : " . $response;
}
curl_close($ch);
import requests
# URL de l’endpoint API (mode sandbox)
endpoint = "https://api.easyjobs.fr/v1-sandbox/json/jobs-delete"
# Authentification
api_token = "API_TOKEN" # Token d’authentification Bearer
secret_key = "SECRET_KEY" # Clé secrète utilisateur
# Payload JSON
payload = {
"jobs": {
"job": [
{ "id": "4M0123456N43N25" },
{ "id": "4M0123456N43N26" }
]
}
}
# En-têtes HTTP requis
headers = {
"Authorization": f"Bearer {api_token}", # Token d’authentification
"Usersecretkey": secret_key, # Clé secrète utilisateur
"Content-Type": "application/json", # Format JSON
"Accept-Language": "fr", # Langue de la réponse (valeurs possibles : en, fr, es)
"User-Agent": "EasyJobsClient/1.0", # Identifiant de l’application appelante (nom + version)
"X-Client-Lang": "Python", # Indique au serveur la technologie cliente, afin d’adapter le formatage de la réponse
"Origin": "https://www.domaine-origine.com" # Remplacez par l’URL depuis laquelle vous appelez l’API
}
# Envoi de la requête DELETE
response = requests.delete(endpoint, headers=headers, json=payload)
# Affichage de la réponse API
print("Réponse de l’API :", response.text)
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
namespace EasyJobsApi
{
class Program
{
static async Task Main(string[] args)
{
// URL de l’endpoint API (mode sandbox)
var endpoint = "https://api.easyjobs.fr/v1-sandbox/json/jobs-delete";
// Authentification : Token API et clé secrète utilisateur
var apiToken = "API_TOKEN"; // Token d’authentification Bearer
var secretKey = "SECRET_KEY"; // Clé secrète utilisateur
using (var client = new HttpClient())
{
// Ajout des en-têtes requis
client.DefaultRequestHeaders.Add("Authorization", $"Bearer {apiToken}"); // Token d'authentification
client.DefaultRequestHeaders.Add("Usersecretkey", secretKey); // Clé secrète utilisateur
client.DefaultRequestHeaders.Add("Accept-Language", "fr"); // Langue de la réponse (valeurs possibles : en, fr, es)
client.DefaultRequestHeaders.Add("User-Agent", "EasyJobsClient/1.0"); // Identifiant de l’application appelante (nom + version)
client.DefaultRequestHeaders.Add("X-Client-Lang", "C#"); // Indique au serveur la technologie cliente, afin d’adapter le formatage de la réponse
client.DefaultRequestHeaders.Add("Origin", "https://www.domaine-origine.com"); // Remplacez par l’URL depuis laquelle vous appelez l’API
// Données à envoyer pour supprimer les offres d’emploi (JSON)
var jsonData = $@"
{{
""jobs"": {{
""job"": [
{{
""id"": ""4M0123456N43N25""
}},
{{
""id"": ""4M0123456N43N26""
}}
]
}}
}}";
var content = new StringContent(jsonData, Encoding.UTF8, "application/json");
try
{
// Envoi de la requête DELETE à l’API
HttpResponseMessage response = await client.DeleteAsync(endpoint);
// Lecture et affichage de la réponse de l’API
string responseContent = await response.Content.ReadAsStringAsync();
Console.WriteLine($"Code de réponse : {response.StatusCode}");
Console.WriteLine("Réponse de l’API :");
Console.WriteLine(responseContent);
}
catch (Exception ex)
{
// Gestion des erreurs réseau ou autres exceptions
Console.WriteLine($"Erreur : {ex.Message}");
}
}
}
}
}
// index.js
// Node.js 18+
/**
* Copiez ce code dans un fichier appelé `index.js`, dans un nouveau dossier sur votre ordinateur.
*
* Ouvrez ce dossier avec un éditeur de code comme Visual Studio Code (VS Code).
*
* Assurez-vous que Node.js est installé sur votre machine. Si ce n’est pas le cas, téléchargez-le ici : https://nodejs.org
*
* Dans le terminal, entrez cette commande pour initialiser :
* > npm install node
*
* Lancez le script depuis le terminal :
* > node index.js
*
* Si tout est correct, la réponse de l’API s’affichera dans la console.
* En cas d’erreur, un message clair s’affichera pour vous aider à corriger.
**/
// Données à envoyer (JSON)
const data = {
jobs: {
job: [
{ id: "4M0123456N43N25" },
{ id: "4M0123456N43N26" }
]
}
};
const apiToken = "API_TOKEN";
const secretKey = "SECRET_KEY";
async function deleteJobs() {
try {
const response = await fetch("https://api.easyjobs.fr/v1-sandbox/json/jobs-delete", {
method: "DELETE",
headers: {
"Authorization": `Bearer ${apiToken}`, // Token d’authentification
"Usersecretkey": secretKey, // Clé secrète utilisateur
"Content-Type": "application/json", // Format JSON
"Accept-Language": "fr", // Langue de la réponse (valeurs possibles : en, fr, es)
"User-Agent": "EasyJobsClient/1.0", // Identifiant de l’application appelante (nom + version)
"X-Client-Lang": "Javascript", // Indique au serveur la technologie cliente, afin d’adapter le formatage de la réponse
"origin": "https://www.domaine-origine.com" // Remplacez par l’URL depuis laquelle vous appelez l’API
},
body: JSON.stringify(data) // Conversion de l’objet JS en chaîne JSON
});
const text = await response.text();
try {
// Affichage de la réponse de l’API
console.log("Réponse de l’API :", JSON.parse(text));
} catch {
// Gestion des erreurs réseau ou autres exceptions
console.error("Erreur lors de l’envoi de la requête :", text);
}
} catch (error) {
console.error(error);
}
}
deleteJobs();
| Code HTTP | Signification | Description |
|---|---|---|
| 200 | OK | Offre supprimée avec succès. |
| 400 | Bad Request | Requête invalide (exemple : identifiant manquant, vide ou mal formé). |
| 403 | Forbidden | Authentification échouée (jeton ou clé invalide), ou origine non autorisée. |
| 404 | Not Found | L’offre à supprimer n’a pas été trouvée. L’identifiant est peut-être incorrect ou déjà supprimé. |
| 405 | Method Not Allowed | Méthode HTTP incorrecte (exemple : GET ou POST au lieu de DELETE). |
| 500 | Internal Server Error | Erreur inattendue côté serveur. Contactez le support si le problème persiste. |
| Code | Message | Cause probable |
|---|---|---|
| 400 | Le champ 'id' est obligatoire. | L’identifiant de l’offre est requis pour effectuer la suppression. |
| 403 | Non autorisé. Jeton invalide. | Jeton d’authentification incorrect ou expiré. |
| 403 | Origine non autorisée. | L’en-tête Origin est manquant ou non autorisé. |
| 404 | L’offre d’emploi est introuvable. Elle a peut-être été supprimée. | Aucun enregistrement correspondant à l’identifiant transmis. |
| 405 | Méthode non autorisée. | Méthode HTTP incorrecte (exemple : POST au lieu de DELETE). |
| 500 | Erreur interne du serveur. | Exception côté serveur. |
Avant d’envoyer une requête de suppression, assurez-vous que les identifiants d’offres sont corrects et à jour. Une suppression est définitive et ne peut pas être annulée. En cas de doute, consultez la documentation des erreurs.