Valeurs d'un référentiel

Description

Retourne les valeurs associées à un référentiel identifié par son code (tel que renvoyé par la route Liste des référentiels).

---

Endpoint

GET https://api.mytalentplug.com/resources/v1/referentials/{code}

---

Authentification

• Requise : Oui
• Type : Bearer Authentication
• Exemple d'en-tête :

Authorization: Bearer <token>

---

Requête

Paramètres de route

Nom du paramètre	Type	Requis	Format	Exemple	Description
code	string	Oui	—	job_contract	Code du référentiel (insensible à la casse). Doit faire partie de la liste exposée par la route des référentiels

---

Codes de référentiels exposés

Ci-dessous, un exemple des reférentiels disponibles. La liste complète peut être récupéré via le endpoint Liste des référentiels.

referentialCode
applicant_degree
applicant_experience
application_mode
job_contract
job_duration
job_function
job_industry
job_statute
job_type
offer_language
remote_work_type
recruiter_type
salary_currency
salary_from
salary_from_per_day
salary_from_per_hour
salary_from_per_month
salary_from_per_week
salary_per
salary_to
salary_to_per_day
salary_to_per_hour
salary_to_per_month
salary_to_per_week

---

Réponse

La réponse est au format JSON.

Réponse 200 (succès)

Exemple

{
  "referentialCode": "job_contract",
  "items": [
    {
      "id": "ref_123abcd",
      "label": "CDI"
    }
  ]
}

Détail des champs

Propriétés de la réponse

Champ	Type	Description
referentialCode	string	Code canonique du référentiel.
items	array	Valeurs du référentiel. Voir items.

Schéma items

Champ	Type	Description
id	string	Identifiant à réutiliser dans requêtes pour référencer cet élément.
label	string	Libellé.

Réponses d'erreur

Code HTTP	Message	Description
400	Bad Request	Le code n'est pas reconnu
401	Unauthorized	Jeton d'accès manquant ou invalide
403	Forbidden	Accès refusé
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 avec curl

curl -X GET 'https://api.mytalentplug.com/resources/v1/referentials/job_contract' \
  -H 'Authorization: Bearer <token>'