Migration de l'API v1 vers l'API v2

Endpoints

BASE URL v1: https://api.letudiant.fr/v6
BASE URL v2: https://jobs-stages.letudiant.fr

Attention : Le header Content-Type: x-www-form-urlencoded est à supprimer de vos requêtes.

v1	v2
POST /jsa/adverts/0	POST /adverts
POST /jsa/adverts/1	POST /adverts
POST /jsa/adverts/2	POST /adverts
POST /jsa/adverts/8	POST /adverts
PATCH /jsa/adverts/partners/{advertPartnerRef}/archive	PATCH /adverts/{id}/archive
PUT /jsa/adverts/partners/{advertPartnerRef}	PUT /adverts/{id}
GET /jsa/adverts/referencials/all	N/A
N/A	GET /referentials/adverts/application-types
GET /jsa/adverts/referencials/contrat	GET /referentials/adverts/contract-types
GET /jsa/adverts/referencials/domaine	GET /referentials/adverts/domains
GET /jsa/adverts/referencials/duree	GET /referentials/adverts/durations
GET /jsa/adverts/referencials/experience	GET /referentials/adverts/experiences
GET /jsa/adverts/referencials/fonction	GET /referentials/adverts/jobs
GET /jsa/adverts/referencials/niveau	GET /referentials/adverts/levels
GET /jsa/adverts/referencials/type	GET /referentials/adverts/types
GET /jsa/adverts/referencials/status	N/A
GET /jsa/adverts/referencials/contrat-alternance	N/A
GET /ref/geo/referencials/ville	GET /referentials/geo/cities
GET /ref/geo/referencials/pays	GET /referentials/geo/countries
GET /ref/geo/referencials/departement	N/A

Précisions : Le type d'annonce n'est plus en query param, l'info est directement dans le body (champ type). Un nouveau référentiel (application-types) existe en conséquence.

Utilisation d'ID au lieu des "PartnerRef"

Maintenant, pour modifier ou archiver une annonce, il faut spécifier son ID dans l'URL.
ID que vous pouvez obtenir lors de la création d'une annonce (dans la réponse), mais aussi en appelant : GET /adverts/{partnerRef} (l'id est dans la réponse)

Champs d'une annonce

v1	v2	Commentaire
complements	/	Supprimé
confidentielle	/	Supprimé
date_debut_mission	/	Supprimé
departements	/	Supprimé
description	/	Supprimé
domaines	businessSectors
duree_mission	missionDurations
duree_periode	durationInformations
email_postulation	recruiterEmail
employeur	employer
experience	experiences
fonction	jobs
france_villes	cities
libelle	label
libelle_contact	applicationContact
mission	missionDescription
monde_villes	foreignLocations
niveaux	studyLevels
nombre_postes	nbOpenings
ref_partenaire	partnerRef
pays	country
postulation_directe_adresse	/	Remplacé par applicationType
postulation_directe_email	/	Remplacé par applicationType
postulation_directe_fax	/	Remplacé par applicationType
postulation_directe_telephone	/	Remplacé par applicationType
postulation_directe_internet	/	Remplacé par applicationType
postulation_modalites	/	Supprimé
profil	profileDescription
remuneration	salary
statut	/	Supprimé
top_liste	/	Supprimé
type_alternance	/	Supprimé
type_contrat	contractTypes
/	applicationType	Cf Référentiel
/	applicationValue	Votre email si applicationType = email, votre site internet si applicationType = internet
/	locationInformations	Informations complémentaires sur la localisation
/	logo	URL du logo de l'entreprise
/	logoLinkUrl	Lien du site (au clique sur le logo)
/	type	Cf Référentiel

Cf la documentation des annonces pour plus de précisions.

Réponses

Création d'une annonce

Le retour a été modifié :

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

Status Code

Les status code de succès pour les POST, sont maintenant des 201

Référentiels

Changement des retours des référentiels :

// V1
{
    "content": {
        "fonction": {
            "id fonction 1": "label fonction 1",
            "id fonction 2": "label fonction 2",
            ...
        }
    }
}

// V2
[
  {
    "id": 1,
    "label": "Label 1"
  },
  {
    "id": 2,
    "label": "Label 2"
  },
  {
    "id": 3,
    "label": "Label 3"
  }
  ...
]