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