Envoyer des candidatures

Description

Ce endpoint permet de créer une nouvelle candidature pour une offre d'emploi spécifiée.

---

Endpoint

POST https://api.mytalentplug.com/jar/v1/jobapplication/new

Authentification

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

Authorization: Bearer <token>

---

Requête

Corps de la requête

La requête doit être envoyée au format JSON avec les informations du candidat et de l'offre d'emploi.

Exemple

{
  "jobOfferPublicationId": "147227477",
  "applicantFirstName": "Jane",
  "applicantLastName": "Smith",
  "applicantEmail": "jane.smith@example.com",
  "applicantPhoneNumber": "+1987654321",
  "externalSource": {
    "externalId": "indeed-67890"
  },
  "attachments": [
    {
      "fileName": "body.html",
      "fileContent": "PCFET0N....",
      "type": 2
    }
  ]
}

Détail des champs

Propriétés de la requête

Champ	Type	Requis	Format	Description
jobOfferPublicationId	string	Oui	—	Identifiant de l'offre d'emploi.
applicantEmail	string	Oui	Email valide	Adresse e-mail du candidat.
applicantFirstName	string	Oui	—	Prénom du candidat.
applicantLastName	string	Oui	—	Nom de famille du candidat.
applicantPhoneNumber	string	Non	—	Numéro de téléphone du candidat.
externalSource	object	Non	—	Source externe de la candidature. Voir externalSource
attachments	array	Oui	—	Liste des fichiers joints à la candidature. Voir attachments

Schéma externalSource

Champ	Type	Requis	Description
externalId	string	Non	Identifiant de la candidature dans le système source.

Schéma attachments

Champ	Type	Requis	Description
fileName	string	Oui	Nom du fichier.
fileContent	string	Oui	Contenu du fichier encodé en base64.
type	integer	Oui	Type du fichier. Les valeurs possibles sont : 0 : Pièce jointe — Document joint à la candidature (CV, lettre de motivation,...) 1 : Message — Message associé à la candidature (ex : HTML)

---

Réponse

La réponse est au format JSON.

Réponse 202 (succès)

Exemple

{
  "id": "a1b2c3d4-e5f6-7890-abcd-1234567890ef"
}

Détail des champs

Propriétés de la réponse

Champ	Type	Description
id	string (UUID)	Identifiant unique de la candidature créée.

---

Réponses d'erreur

Code HTTP	Message	Description
400	Bad Request	Erreur de validation.
404	Not Found	Offre d'emploi introuvable.
409	Conflict	Candidature déjà existante (doublon).
410	Gone	Offre expirée ou supprimée.

---

Exemple de requête avec curl

curl -X POST 'https://api.mytalentplug.com/jar/v1/jobapplication/new' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <token>' \
-d '{
  "jobOfferPublicationId": "147227477",
  "applicantFirstName": "Jane",
  "applicantLastName": "Smith",
  "applicantEmail": "jane.smith@example.com",
  "applicantPhoneNumber": "+1987654321",
  "externalSource": {
    "externalId": "indeed-67890"
  },
  "attachments": [
    {
      "fileName": "body.html",
      "fileContent": "PCFET0N....",
      "type": 2
    }
  ]
}'