API CEP : afficher les offres d’emploi et de bénévolat protestantes sur votre site

Le Carrefour de l’Engagement Protestant (CEP) met à disposition une API publique, gratuite et sans authentification permettant à toute association, fédération, paroisse ou organisation protestante d’afficher les dernières offres d’emploi et de bénévolat publiées sur engagement-protestant.fr directement sur son propre site web.

Cette page documente le fonctionnement technique de l’API ainsi qu’un exemple concret de mise en œuvre. Elle s’adresse aux webmasters, intégrateurs et développeurs souhaitant relayer les offres du CEP sur leur site.

Pourquoi diffuser les offres CEP sur votre site ?

  • Augmenter la visibilité des offres d’emploi et de bénévolat protestantes auprès de votre communauté.
  • Enrichir votre site avec un contenu actualisé automatiquement, sans intervention manuelle.
  • Soutenir l’écosystème associatif protestant en facilitant les recrutements et l’engagement bénévole.
  • Mutualiser les efforts : une seule source d’offres, des dizaines de relais possibles.

L’API CEP en bref

  • URL de l’endpoint : https://engagement-protestant.fr/wp-json/jobs/v1/latest
  • Méthode HTTP : GET
  • Authentification : aucune (API publique en lecture seule)
  • Format de réponse : JSON (UTF-8)
  • Contenu retourné : les dernières offres d’emploi et de bénévolat publiées
  • CORS : autorisé pour les appels côté navigateur
  • Tarif : gratuit

Endpoint et format de réponse

Un simple appel GET sur l’endpoint suivant retourne un tableau JSON :

GET https://engagement-protestant.fr/wp-json/jobs/v1/latest

Exemple de réponse :

[
    {
      "title": "Animateur·trice jeunesse — CDI temps plein",
      "company": "Église protestante unie de Lyon",
      "date": "2026-05-10 14:32:00",
      "url": "https://www.engagement-protestant.fr/offre/animateur-jeunesse-lyon/",
      "image": {
        "full":  "https://www.engagement-protestant.fr/wp-content/uploads/2026/05/visuel.jpg",
        "thumb": "https://www.engagement-protestant.fr/wp-content/uploads/2026/05/visuel-300x200.jpg",
        "alt":   "Animation jeunesse à Lyon"
      }
    },
    {
      "title": "Bénévole accueil — Entraide protestante de Marseille",
      "company": "Entraide protestante",
      "date": "2026-05-08 09:15:00",
      "url": "https://www.engagement-protestant.fr/offre/benevole-accueil-marseille/",
      "image": {
        "full":  "https://www.engagement-protestant.fr/wp-content/uploads/2026/05/marseille.jpg",
        "thumb": "https://www.engagement-protestant.fr/wp-content/uploads/2026/05/marseille-300x200.jpg",
        "alt":   "Accueil entraide Marseille"
      }
    }
  ]

Description des champs

  • title (string) : intitulé de l’offre.
  • company (string) : structure qui recrute.
  • date (string, format Y-m-d H:i:s) : date de publication de l’offre.
  • url (string) : lien direct vers la page complète de l’offre sur engagement-protestant.fr.
  • image.full / image.thumb / image.alt : visuel d’illustration (URL haute résolution, vignette, texte alternatif).

Exemple d’intégration : le site de la FEP

La Fédération de l’Entraide Protestante (FEP) intègre les offres CEP sur ses pages d’événements grâce à un bloc Gutenberg dédié. Vous pouvez voir le rendu en bas de cette page : fep.asso.fr.

Le bloc des offres d'emploi CEN sur le site de la FEP

L’intégration FEP affiche les deux dernières offres avec image, titre, date relative (« Publié il y a 2 jours »), un lien direct vers l’offre et un appel à l’action vers la page « Toutes les offres » du CEP.

Comment intégrer l’API sur votre site ?

Côté serveur (PHP / WordPress)

$response = wp_remote_get( 'https://engagement-protestant.fr/wp-json/jobs/v1/latest', [
      'timeout' => 5,
  ] );

  if ( ! is_wp_error( $response ) ) {
      $annonces = json_decode( wp_remote_retrieve_body( $response ), true );
      // Boucle d'affichage : title, company, date, url, image.full
  }

Côté navigateur (JavaScript)

fetch('https://engagement-protestant.fr/wp-json/jobs/v1/latest')
    .then(r => r.json())
    .then(annonces => {
      // Construire dynamiquement les cartes d'offres
    });

Bonnes pratiques (cache, accessibilité, mise à jour)

  • Mettez en cache la réponse au moins 1 heure (transient WordPress, Redis, fichier local…). L’API renvoie les mêmes données pendant plusieurs heures, inutile d’appeler à chaque visite.
  • Implémentez un fallback « stale » : si l’API est temporairement indisponible, continuez à afficher la dernière version connue plutôt qu’une erreur.
  • Liens externes : ouvrir les offres dans un nouvel onglet (target="_blank" rel="noopener noreferrer") et indiquer « (nouvelle fenêtre) » aux lecteurs d’écran (RGAA).
  • Image d’illustration : utilisez le champ image.alt retourné par l’API ; à défaut, laissez l’attribut alt vide (image décorative).
  • Date relative : afficher « Publié il y a X jours » est plus engageant qu’une date brute.

Conditions d’utilisation

  • Les offres affichées doivent renvoyer vers la fiche complète sur engagement-protestant.fr (champ url de l’API).
  • Mention recommandée : « Offres fournies par le Carrefour de l’Engagement Protestant ».
  • Ne pas modifier le contenu des offres ni détourner leur usage commercial.
  • Le CEP se réserve le droit de modifier la structure de l’API ; tout changement majeur sera annoncé sur cette page.

👉 Pour toute question technique sur l’API : Contactez qodop