Aller au contenu

Ajouter

Requête HTTP

POST /adverts

Corps de la requête

Paramètre Type Requis Validateur Note
applicationContact Texte Oui Max longueur : 255 Nom du contact
applicationType Entier Oui Liste des types Type de postulation
applicationValue Texte Conditionné Max longueur : 255 Votre email si applicationType = email, votre site internet si applicationType = internet
businessSectors Tableau d'entier Oui Liste des domaines Domaine métier de l'annonce. Il peut y avoir des domaines en doublon dans la réponse API. Il s’agit en réalité d’une relation parent / enfant. Prenez toujours celui avec l’ID le plus haut qui correspond à l’enfant.
cities Tableau d'entier Conditionné Liste des villes françaises Requis si country = France
contractTypes Tableau d'entier Conditionné Liste des types Requis si type = job ou emploi
country Entier Oui Liste des pays
durationInformations Texte Non Max longueur : 255 Informations complémentaires sur la durée (ex: 6mois à partir de juin)
employer Texte Oui Max longueur : 255 Nom de l'entreprise employeur
experiences Tableau d'entier Conditionné Liste des expériences Requis si type = emploi
foreignLocations Texte Conditionné Max longueur : 255 Requis si country != France, ville en texte
jobs Tableau d'entier Conditionné Liste des métiers Requis si type = emploi
label Texte Oui Max longueur : 255 Nom de l'annonce
locationInformations Texte Non Max longueur : 255 Informations complémentaires sur la localisation
logo Texte Non Max longueur : 255 URL du logo de l'entreprise
logoLinkUrl Texte Non Max longueur : 255 Lien du site (au clique sur le logo)
missionDescription Texte Oui Max longueur : 65535 Description de l'annonce (texte inline avec les paragraphes d'échappés via \n)
missionDurations Tableau d'entier Non Liste des durées Durée(s) de la mission
nbOpenings Entier Oui Positif Nombre de postes
partnerRef Texte Non Max longueur : 100 Référence externe (chez vous) de votre annonce
profileDescription Texte Oui Max longueur : 65535 Description du profil recherché (texte inline avec les paragraphes d'échappés via \n)
publicationEndDate Texte Non Date (YYYY-MM-DD ou DD-MM-YYYY) +30 jours par défaut
recruiterEmail Texte Non Max longueur : 100 Email du recruteur
salary Texte Conditionné Max longueur : 200 Requis si type != alternance, salaire ou fourchette de salaires
studyLevels Tableau d'entier Conditionné Liste des niveaux d'étude Requis si type != job
type Entier Oui Liste des types

Réponse de la requête

201 - Succès

{
  "content": {
    "id": "{id}",
    "url": "https://jobs-stages.letudiant.fr/{type}/annonce/{slug}.html"
  }
}

400 - Erreur(s) - Body non valide

{
  "errors": {
    "global": [
      {
        "message": "ERROR_MESSAGE" // Item not found for resource "App\Entity\Geo\Country" with id "123".
      }
    ]
  }
}

401 - Erreur - Non autorisé

{
  "errors": {
    "global": [
      {
        "message": "Partner not found with given token"
      }
    ]
  }
}

422 - Erreur - Erreur(s) de validation

{
  "errors": {
    "global": [
      {
        "propertyPath": "ATTRIBUTE_NAME", // recruiterEmail
        "message": "ERROR_MESSAGE" // Ceci n'est pas un e-mail valide
      },
      {
        "propertyPath": "ATTRIBUTE_NAME",
        "message": "ERROR_MESSAGE"
      }
    ]
  }
}