Énumérer les offres

Cette API permet de récupérer la liste des offres d'emploi disponibles pour votre compte.

Endpoint

POST https://canadamotorjobs.com/api/v1/{locale}/job-listings

Authentification

L'API nécessite une authentification Bearer. Incluez le token dans l'en-tête de la requête :

Authorization: Bearer <votre_token>

Paramètres de requête

Paramètre	Type	Description	Requis	Défaut
page	number	Numéro de la page	Non	1
locale	string : en, fr, es	Langue de l'offre d'emploi	Non	fr
limit	number	Nombre d'éléments par page	Non	10
search	string	Terme de recherche	Non	null
location	string	Localisation	Non	null
category	string	Catégorie d'emploi	Non	null

Description des champs

Champ	Type	Description
id	string	Identifiant unique de l'offre d'emploi de notre site
ref_id	string|null	Identifiant de référence sur votre système
name	string	Nom de l'offre d'emploi
business.id	string	Identifiant unique de l'entreprise de notre site
business.ref_id	string|null	Identifiant de référence de l'entreprise sur votre système
business.name	string	Nom de l'entreprise
business.logo	string	URL du logo de l'entreprise
business.location	string	Adresse de l'entreprise
business.lat	number	Latitude de l'entreprise
business.lng	number	Longitude de l'entreprise
logo	string	URL du logo de l'offre d'emploi
location	string	Adresse du poste
lat	number	Latitude du poste
lng	number	Longitude du poste
distance	float|null	Distance en km entre la localisation fournie et l'offre d'emploi
salary.value	float	Montant du salaire
salary.hourly	boolean	Indique si le salaire est calculé sur une base horaire
salary.show	boolean	Indique si le salaire doit être affiché
salary.method	string	Méthode de calcul du salaire
salary.before_text	string	Texte à afficher avant le salaire
salary.commissions	boolean	Indique si le salaire inclut des commissions
salary.bonusses	boolean	Indique si le salaire inclut des bonus
salary.html	html	Représentation HTML du salaire
type	string	Type de poste
sector	string	Secteur d'activité
department	string	Département
job_title	string	Titre du poste
status	string	Statut de l'offre d'emploi
activated_at	string	Date d'activation
start_at	string	Date de début
end_at	string	Date de fin
filled_at	string	Date à laquelle le poste a été pourvu
created_at	string	Date de création
updated_at	string	Date de dernière mise à jour
applications_count	number	Nombre de candidatures reçues

Erreurs

401 Unauthorized

{
  "error": "Token d'authentification invalide ou manquant"
}

403 Forbidden

{
  "error": "Vous n'avez pas les permissions nécessaires"
}

Exemple d'utilisation

curl -X GET \
  'https://api.canadamotorjobs.com/api/job-listings?page=1&limit=10' \
  -H 'Authorization: Bearer votre_token_ici'

Notes

• Le token d'authentification doit être valide et non expiré
• La pagination est automatique avec une limite par défaut de 10 éléments par page
• Les résultats sont triés par date de création (du plus récent au plus ancien)