Envoyer des candidatures

Description

Créé 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 (JSON)

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": "+33687654321",
  "externalSource": {
    "externalId": "REF1456"
  },
  "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 document (Valeur possible dans "Type de pièce jointe" ci-dessous).

Type de pièce jointe

Code	Libelle	Description
0	Untyped	Type de document non identifié
1	Message	Message associé à la candidature
2	Resume	Curriculum vitae
3	CoverLetter	Lettre de motivation
4	Archive	Archive (format compressé)
5	Other	Autre type de document

---

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
401	Unauthorized	Jeton d'accès manquant ou invalide
403	Forbidden	Accès refusé
404	Not Found	Offre d'emploi introuvable
409	Conflict	Candidature déjà existante (doublon)
410	Gone	Offre expirée ou supprimée
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 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": "+33687654321",
  "externalSource": {
    "externalId": "REF-5467"
  },
  "attachments": [
    {
      "fileName": "body.html",
      "fileContent": "PCFET0N....",
      "type": 2
    }
  ]
}'