Récupération du statut des publications d'une offre

Description

Récupère les statuts des publications associées à une offre. Un jobboard peut être précisé pour limiter le résultat à sa publication.

---

Endpoint

GET https://api.mytalentplug.com/job/v1/status/{jobOfferId}/{jobBoardId}

Authentification

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

Authorization: Bearer <token>

---

Requête

Paramètres de route

Nom du paramètre	Type	Requis	Format	Exemple	Description
jobOfferId	string	Oui	UUID	5c357095-eb76-41d9-a896-b7fa5193e3ad	Identifiant de l'offre
jobBoardId	string	Non	jb_...	jb_o7a4161	Identifiant du jobboard. Sans ce paramètre, toutes les publications de l'offre sont retournées

---

Réponse

La réponse est au format JSON.

Réponse 200 (succès)

Exemple

{
  "jobOfferId": "5c357095-eb76-41d9-a896-b7fa5193e3ad",
  "publications": [
    {
      "jobBoardId": "jb_o7a4161",
      "jobBoardName": "Example Jobboard",
      "status": 4,
      "statusLabel": "Online",
      "message": null,
      "externalUrl": "https://example.com/jobs/123",
      "lastUpdated": "2026-07-15T09:30:00Z"
    }
  ]
}

Détail des champs

Propriétés de la réponse

Champ	Type	Description
jobOfferId	string (UUID)	Identifiant de l'offre.
publications	array	Publications associées à l'offre, éventuellement filtrées par jobboard. Voir publications.

Schéma publications

Champ	Type	Description
jobBoardId	string	Identifiant du jobboard.
jobBoardName	string	Nom du jobboard.
status	integer	Valeur technique du statut (voir "Statuts" ci-dessous).
statusLabel	string	Libellé lisible du statut.
message	string ou null	Message associé au dernier traitement.
externalUrl	string ou null	URL de l'offre sur le jobboard.
lastUpdated	string ou null	Date de dernière mise à jour au format ISO 8601.

Statuts

Valeur	Statut	Libellé
0	Created	Created
1	Planned	Scheduled
2	Sent	Sent
3	InProgress	In Progress
4	Online	Online
5	ArchiveInProgress	Archiving
6	Archived	Archived
7	EditingError	Editing Error
8	Error	Error
9	Canceled	Canceled
10	Expired	Expired
11	Expiring	Expiring

Réponses d'erreur

Code HTTP	Message	Description
400	Bad Request	L'identifiant du jobboard est invalide
401	Unauthorized	Jeton d'accès manquant ou invalide
403	Forbidden	Accès refusé
404	Not Found	L'offre ou la publication demandée n'existe pas
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 requête avec curl

curl -X GET 'https://api.mytalentplug.com/job/v1/status/5c357095-eb76-41d9-a896-b7fa5193e3ad/jb_o7a4161' \
-H 'Authorization: Bearer <token>'