Factures d'une offre d'emploi
Cet endpoint permet de récupérer la liste des factures liées à une offre d'emploi spécifique.
Endpoint
POST https://canadamotorjobs.com/api/v1/{locale}/job-listings/invoices
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 |
|---|---|---|---|---|
| job_listing_id | string | L'identifiant unique de l'offre d'emploi | Non | |
| page | number | Numéro de la page | Non | 1 |
| per_page | number | Nombre de factures par page | Non | 10 |
| status | string : paid, pending, failed | Statut de la facture | Non | all |
| from | date: YYYY-MM-DD | Date de début | Non | null |
| to | date: YYYY-MM-DD | Date de fin | Non | aujourd'hui |
| sort_by | string | Critère de tri | Non | created_at |
| sort_direction | string : asc, desc | Direction du tri | Non | desc |
Erreurs
| Code | Message | Description |
|---|---|---|
| 200 | OK | La liste des factures a été récupérée avec succès |
| 404 | Not Found | L'offre d'emploi spécifiée n'existe pas |
| 403 | Forbidden | Vous n'êtes pas autorisé à accéder à cette offre d'emploi |
| 401 | Unauthorized | L'authentification est requise |
Notes
- Les factures sont triées par date de création (descendant) par défaut.
- Vous pouvez modifier le critère de tri et la direction du tri en utilisant les paramètres
sort_byetsort_direction. - Les factures sont liées à une offre d'emploi spécifique.