Cette section regroupe les limites techniques, les règles de validation, ainsi que les comportements spécifiques communs à l’ensemble des endpoints de l’API EasyJobs. Veuillez en tenir compte pour éviter des erreurs ou un rejet de vos requêtes.
Le tableau suivant présente les limites techniques applicables à certains champs des offres d’emploi, notamment les longueurs maximales, les types de données et les contraintes de format ou de valeurs. Pour une description complète de chaque champ (signification, usage, exemples), consultez la Référence des champs.
| Champ | Type | Longueur maximale | Spécifications du champ |
|---|---|---|---|
id |
string | 128 | Alphanumérique, requis. |
title |
string | 160 | Titre de l'annonce (ex : Développeur Java), sans balises HTML. |
description |
string | 1024 | Description de l’entreprise, permet le HTML léger. |
position |
string | 12288 | Description de l’offre d’emploi, permet le HTML léger. |
profile |
string | 12288 | Profil recherché, permet le HTML léger. |
contract_type |
string | 64 | Valeurs attendues : CDI, CDD, Intérim, Stage, Alternance. |
location |
string | 64 | Lieu du poste (ex : Paris, Marseille). |
postcode |
string | 5 | Code postal, 5 chiffres (ex : 75001, 13008). |
region |
string | 32 | Nom de région (ex : Île-de-France, Bretagne). |
country |
string | 64 | Nom du pays en toutes lettres (ex : France, Belgique). |
subsidiary |
string | 64 | Nom de l'entreprise ou entité. |
available |
integer | 3 | Postes disponibles, nombre entier positif (ex : 1, 2, 5...). |
posted_via |
string | 64 | Identifiant de la source de publication (ex : EasyJobs, API Partenaire). |
Taille maximale d’un corps JSON ou XML : 3 Mo. Cette limite permet de transmettre environ 500 à 600 offres complètes en une seule requête, selon le niveau de détail.
- Limite par IP : 100 requêtes par minute / 1000 requêtes par heure
- Concurrence : 5 requêtes simultanées par utilisateur.
- Timeout : 15 secondes par requête.
- Taille maximale du payload : 3 Mo par requête POST / PUT.
- Code de réponse :
429 Too Many Requests - Header de retour :
Retry-After(en secondes)
Si vous atteignez ces limites, attendez avant de relancer votre requête. L’en-tête Retry-After précise quand il est possible de relancer la requête après un dépassement de quota. Pour les stratégies de relance en cas d’échec temporaire (erreurs 429, 5xx), consultez la page : Retry limité
- Champs obligatoires : doivent être présents et valides.
- Champs vides ou mal formés : provoquent une erreur
400. - Formats attendus :
- ID : uniquement alphanumérique, 4 à 128 caractères
- Date :
YYYY-MM-DD HH:mm:ss - Salaire :
nombre + symbole + période(ex: 30000€/an)
- Champs non reconnus : ignorés automatiquement.
job-posting/jobs-posting: les champs obligatoires doivent contenir une valeur.job-edit/jobs-edit: les champs obligatoires envoyés vides conservent la valeur précédente.- Les champs non obligatoires peuvent être supprimés en les envoyant vides.
- Tous les champs doivent respecter leur type et format, même s’ils sont facultatifs.
Pour plus de détails, consultez la section "Tableau des champs".
| Code HTTP | Signification | Cause probable |
|---|---|---|
| 400 | Bad Request | Données invalides ou champ manquant. |
| 413 | Payload Too Large | Corps de requête supérieur à 3 Mo. |
| 422 | Unprocessable Entity | Format correct mais contenu incohérent ou rejeté. |
| 429 | Too Many Requests | Trop de requêtes envoyées dans un court laps de temps. |
Consultez la documentation complète des erreurs pour connaître les codes, messages et causes possibles.