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"
}
]
}
}