Chargement en cours ...
Description et paramètres de l’endpoint

L’endpoint job-delete (https://api.easyjobs.fr/v1/job-delete) permet de supprimer une offre d’emploi existante via une requête DELETE. L’identifiant de l’offre à supprimer (id) doit être passé directement dans l’URL, sous la forme d’un paramètre ?id=. Cet endpoint ne nécessite ni corps de requête ni encodage particulier. En retour, l’API fournit une réponse claire selon le résultat de l’opération :

  • 200 OK si l’offre a été supprimée avec succès.
  • 400 Bad Request si l’ID est manquant, mal formaté ou vide.
  • 401 Unauthorized si le jeton d’authentification est manquant ou invalide.
  • 403 Forbidden si la clé secrète est absente, si l’origine n’est pas autorisée.
  • 404 Not Found si l’offre spécifiée n’existe pas ou ne vous appartient pas.
  • 405 Method Not Allowed si vous utilisez une méthode autre que DELETE.
  • 500 Internal Server Error en cas d’erreur inattendue sur le serveur.

Pour supprimer plusieurs offres en une seule requête, utilisez l’endpoint jobs-delete JSON ou jobs-delete XML.

Mode Sandbox : pour tester en toute sécurité

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.

Champs obligatoires

Pour supprimer une offre 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.

Consultez la documentation complète des champs pour en savoir plus sur le format du champ id.

Exemple d’une suppression simple (appel direct via URL)

                  DELETE https://api.easyjobs.fr/v1-sandbox/job-delete?id=4M0123456N43N25
                

Cet exemple illustre une requête DELETE vers l’endpoint job-delete, avec l’identifiant de l’offre passé en paramètre d’URL. Aucun corps de requête n’est requis.

Important : Pour que la suppression soit effective, l'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.

Réponse attendue

                  {
                    "message":"Offre d'emploi supprimée avec succès."
                  }                  
                

En cas d’erreur, consultez la page Gestion des erreurs.

Tester avec cURL

                curl -X DELETE "https://api.easyjobs.fr/v1/job-delete?id=4M0123456N43N25" \
                -H "Authorization: Bearer <API_TOKEN>" \
                -H "Usersecretkey: <SECRET_KEY>" \
                -H "Accept-Language: fr" \
                -H "User-Agent: EasyJobsClient/1.0" \
                -H "X-Client-Lang: <LANGAGE_CLIENT>" \
                -H "Origin: https://www.domaine-origine.com"
                

Aucun corps de requête n’est requis. L’identifiant est transmis directement dans l’URL.

Tester avec Postman
  • Méthode : DELETE
  • URL : https://api.easyjobs.fr/v1/job-delete?id=4M0123456N43N25
  • En-têtes requis :
    • Authorization: Bearer <API_TOKEN>
    • Usersecretkey: <SECRET_KEY>
    • Accept-Language: fr
    • User-Agent: EasyJobsClient/1.0
    • X-Client-Lang: <LANGAGE_CLIENT>
    • Origin: https://www.domaine-origine.com
  • Corps (Body) : aucun corps n’est requis. L’identifiant est passé directement dans l’URL.
Informations d’authentification requises

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.

En-têtes HTTP requis

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.
  • 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.
Exemple complet : modification d’une offre d’emploi via DELETE [PHP] (avec cURL)

                  // URL de l’endpoint API (mode sandbox)
                  $endpoint = "https://api.easyjobs.fr/v1-sandbox/job-delete?id=4M0123456N43N25";

                  // Authentification
                  $apiToken = "API_TOKEN";   // Token d’authentification Bearer
                  $secretKey = "SECRET_KEY"; // Clé secrète utilisateur

                  $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
                      "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, 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
                  ]);

                  $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);
                
Exemple complet : modification d’une offre d’emploi via DELETE [Python] (avec requests)

                  import requests

                  # URL de l’endpoint API (mode sandbox)
                  endpoint = "https://api.easyjobs.fr/v1-sandbox/job-delete?id=4M0123456N43N25"

                  # Authentification
                  api_token = "API_TOKEN"    # Token d’authentification Bearer
                  secret_key = "SECRET_KEY"  # Clé secrète utilisateur

                  # En-têtes HTTP requis
                  headers = {
                      "Authorization": f"Bearer {api_token}",       # Token d’authentification
                      "Usersecretkey": secret_key,                  # Clé secrète utilisateur
                      "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)

                  # Affichage de la réponse API
                  print("Réponse de l’API :", response.text)
                
Exemple complet : modification d’une offre d’emploi via DELETE [C#]

                  using System;
                  using System.Net.Http;
                  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/job-delete?id=4M0123456N43N25";

                              // 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

                                  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 content = await response.Content.ReadAsStringAsync();
                                      Console.WriteLine($"Code de réponse : {response.StatusCode}");
                                      Console.WriteLine("Réponse de l’API :");
                                      Console.WriteLine(content);
                                  }
                                  catch (Exception ex)
                                  {
                                      // Gestion des erreurs réseau ou autres exceptions
                                      Console.WriteLine($"Erreur : {ex.Message}");
                                  }
                              }
                          }
                      }
                  }
                
Exemple complet : modification d’une offre d’emploi DELETE PUT [JavaScript] (avec Node.js)

                  // 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.
                   **/

                  const jobId = "4M0123456N43N25"; // ID de l'offre à supprimer

                  const apiToken = "API_TOKEN";
                  const secretKey = "SECRET_KEY";

                  // Construire l'URL avec le paramètre id en query string (mode sandbox)
                  const endpoint = `https://api.easyjobs.fr/v1-sandbox/job-delete?id=${encodeURIComponent(jobId)}`;

                  async function deleteJob() {
                    try {
                      const response = await fetch(endpoint, {
                        method: "DELETE",
                        headers: {
                          "Authorization": `Bearer ${apiToken}`,       // Token d’authentification
                          "Usersecretkey": secretKey,                  // Clé secrète utilisateur
                          "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
                        }
                        // Pas de body pour ce endpoint (la suppression se fait via le paramètre id dans l'URL)
                      });

                      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);
                    }
                  }

                  deleteJob();
                
Codes HTTP de réponse possibles
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.
Messages d’erreur possibles
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.
Recommandation

Avant d’envoyer une requête de suppression, assurez-vous que l’identifiant de l’offre est correct et à jour. Une suppression est définitive et ne peut pas être annulée. En cas de doute, consultez la documentation des erreurs.

Copyright EasyJobs API © 2025 - Tous droits réservés