Certifier une offre d'emploi

Description

Met à jour le statut d'une offre d'emploi.

---

Endpoint

POST https://api.mytalentplug.com/api/v1/jobofferpublication/certify

Authentification

• Requise : Oui
• Type : Bearer Authentication
• Exemple d'en-tête :

Authorization: Bearer <token>

---

Requête

Corps de la requête (JSON)

Utilisez exactement l'un des deux modes d'identification suivants :

• Par publication : fournissez JobOfferPublicationId seul. L'offre et le jobboard sont retrouvés à partir de cette publication.
• Par offre et jobboard : fournissez ensemble JobOfferId et JobBoardId.

Ne combinez pas JobOfferPublicationId avec JobOfferId ou JobBoardId.

Nom du paramètre	Type	Requis	Format	Exemple	Description
JobOfferPublicationId	string	Selon le mode	UUID non vide ou entier strictement positif, transmis sous forme de chaîne	88b6d070-29aa-4bb6-9808-b2ca02e64883 ou 654321	Identifiant de la publication
JobOfferId	string	Selon le mode	UUID non vide ou entier strictement positif, transmis sous forme de chaîne	ff1e9087-77a1-43b2-adee-6fcfbe0b2210 ou 25429878	Identifiant de l'offre
JobBoardId	string	Avec JobOfferId	Identifiant de jobboard au format jb_...	jb_pdflnzu	Identifiant du jobboard sur lequel l'offre est publiée
OnlineStatus	integer	Oui	Voir "Statuts autorisés" ci-dessous	7	Nouveau statut de publication
JobOfferUrl	string	Non	URL	https://www.jobboard.example/offres/123	URL de l'offre sur le jobboard
Comment	string	Non	—	Une erreur est survenue lors du traitement de la commande	Commentaire associé à l'offre ou raison du rejet

Statuts autorisés

Valeur	Statut	Description
3	JobOfferOnline	Offre certifiée et publiée
4	JobOfferDeleted	Offre supprimée
5	JobOfferEdited	Offre modifiée
6	JobOfferRejectedCommercial	Rejet commercial
7	JobOfferRejectedTechnical	Rejet technique
8	JobOfferRejectedSubscription	Rejet lié à l'abonnement

Exemple avec l'identifiant de publication

{
  "JobOfferPublicationId": "88b6d070-29aa-4bb6-9808-b2ca02e64883",
  "OnlineStatus": 7,
  "JobOfferUrl": "",
  "Comment": "Une erreur est survenue lors du traitement de la commande"
}

Exemple avec l'identifiant d'offre et le jobboard

{
  "JobOfferId": "25429878",
  "JobBoardId": "jb_pdflnzu",
  "OnlineStatus": 3,
  "JobOfferUrl": "https://www.jobboard.example/offres/123",
  "Comment": "Offre publiée"
}

---

Réponse

Réponse 200 (succès)

La demande de certification ou de rejet a été acceptée.

Réponses d'erreur

Code HTTP	Message	Description
400	Bad Request	Corps invalide, mode d'identification absent, incomplet ou mélangé, identifiant invalide, JobOfferPublicationId ne correspondant à aucune publication, ou OnlineStatus différent de 3, 4, 5, 6, 7 et 8
401	Unauthorized	Jeton d'accès manquant ou invalide
403	Forbidden	Accès refusé
429	Too Many Requests	Limite d'appels dépassée (voir Limites d'appels)
500	Internal Server Error	Le serveur a rencontré un problème inattendu

Exemple de validation : statut non autorisé

Les erreurs de validation des champs sont retournées dans un objet errors. Exemple de contenu :

{
  "title": "One or more validation errors occurred.",
  "status": 400,
  "errors": {
    "OnlineStatus": [
      "OnlineStatus must be one of the following values: 3, 4, 5, 6, 7 or 8."
    ]
  }
}

---

Exemples de requêtes avec curl

Par publication

curl -X POST 'https://api.mytalentplug.com/api/v1/jobofferpublication/certify' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <token>' \
-d '{
    "JobOfferPublicationId": "88b6d070-29aa-4bb6-9808-b2ca02e64883",
    "OnlineStatus": 3,
    "JobOfferUrl": "https://www.jobboard.example/offres/123",
    "Comment": "Offre certifiée"
}'

Par offre et jobboard

curl -X POST 'https://api.mytalentplug.com/api/v1/jobofferpublication/certify' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <token>' \
-d '{
    "JobOfferId": "ff1e9087-77a1-43b2-adee-6fcfbe0b2210",
    "JobBoardId": "jb_pdflnzu",
    "OnlineStatus": 3,
    "JobOfferUrl": "https://www.jobboard.example/offres/123",
    "Comment": "Offre certifiée"
}'